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Purpose and Soope 

This document is an attempt to illustrate and explain the general composition of 
OMSGA from a technical aspect by showing the major routines encompassed and inter- 
action between them. Tables, maps and flow charts are included where appropriate 
and available. In general, this document will serve as a guide for implementation 
and upon completion of the system serve as technical documentation for the exec. 
Therefore it will be, by nature, subject to constant change and/or refinements 
until date of release, hence, caution must be used in placing reliance on the 
contents of this document. 

It is assumed the reader is familiar with the UNIVAC 494. hardware and has 
reviewed the functional description manual for the UNIVAC 494- operating system. 



OMEGA 

1.0 Design Philosophy 

OMEGA is a set of integrated routines providing the basic control for coor- 
dinating and executing UNIVAG and user provided programs,. It provides a 
flexible and reliable foundation for the installation environment to build 
upon. OMEGA has been designed explicitly modular to facilitate future extensions, 
expansion of particular functions or selection of available variants of a basic 
function. In the following discussions of the executive functions, a dis- 
tinction is made between "basic exec activities" those required for switching, 
queuing and hardware operation of the machine; and "secondary exec activities" 
those used for selection, task control, input/output and termination. All 
secondary exec activities, although required in some form, have been estab- 
lished by software convention and are replacable. To facilitate their re- 
placement or change, all secondary exec activities operate as worker programs 
activated through formal service request with minimal communication between 
them. This document supplies necessary tables, calling sequences and logic 
of OMEGA to accomodate user modifications to the UNIVAG provided system. 



1,1 Control Thread 

OMEGA is dependent on random access storage as an operating base and upon 
primary input streams as a source of the control language definition of work 
to be performed. Each unit of work to be performed is called a task and 
represents the unit upon which the system performs its selection, allocation 
and activation functions. 

For each task entered into the system, a Task Addendum is formed, which contains 
all pertinent information pertaining to the task (see figure l-l) . To control 
the running of the task and requested fragments. Activity Addendums are formed 
' to order and control fragmentation. 

In addition to Activity Addendums, free storage is needed to perform 
service requests or switching upon interrupts. This additional storage is 
assigned to the particular program when it is required. The core area assigned 
is called a storage module and is twenty octal words. This storage module 
is linked to the Activity Addendum through a push-pop chain. The storage 
module contains all the information necessary for any service request or loss 
of control through an interrupt. The format of an allocated storage module 
is shown in figure 1-3 and the entries, are described in Storage ModulB Def- 
inition. 
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TASK ADDMDIJM FIG. 1-1 
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T , 1 , 1 Task Addendum Definition 

The task addendum is formed by cooperative service routine when a Job 
stream enters the system. Each task (program) described by the Job 
stream will utilize this addendum to contain l/O assignments and other 
control information at the task level . Upon completion of a task the ' . 
addendum is purged of task dependent information and re-used for next 
task in the stream. This will allow select control information and 
I/O assignments to be carried from one task to the next within a J.ob 
stream. • . \ 

" The following describes content of task addendum: 

Word Service priority is a four bit number assigned as the 

highest priority available to the task. • Linked to next 
task addendum contained in the system. 

Word 1 Linked to activity addendum is a 18 bit address of first 
activity established for current task. 

Word 2 Contains the estimated # of time units required of the 
control processor to complete the current task. 7—7 
indicates continuous processing. 

Word .3 The # of time 200 us units currently used by task at this 
point in time. 

Word U Time of day (in 200 increments) this task was activated. 

Word 5 Logical switches - bits 2'^5_2'19 are used for logical, switches 

A through E respectively. If corresponding bit is set (1) 
switch is on: if bit is 0, switch is off. Overflow switches- 
if bit 2;55^ is set (1 } a floating point overflow has occurred. 
If bit 2*^ ' is set (l ) a floating point underflow has occurred 
Lower contains a 15 bit Job Number assigned by the OMEGA to 
identify the Job. 

Wbrd 6 Contains relative addresses of alternate floating point over- 
flow or underflow routines established by task. 

Word 7 Contains relative addresses of alternate error recovery 

routine in the event the task addresses outside its assigned 
code. Illegal operation address is relative address of 
alternate illegal instruction recovery routine. 

Word 10 Contains drum increment to parameters stored by a task un- 
solicited operator enter for conveyence to next task. Drum 
increment is to logical File Code.ZD. 

Word 11 Contains absolute code address assigned to current task and 
length of task in groups of alOOg. 

Word 12 Contains a link to chain descriptors committed by RT/Conmi 
programs only. 

Word 13 Contains address and # of words for an outstanding RECEIVE 
operator. 

Word 14-17 Unas signed 

Word 20-34- Are used to control primary and secondary input/output and 
are explained under cooperative control. 

Word 35-66 s Contains the basic set of logical file codes A-Z which the 
user may assign peripheral devices oy random storage files. 
Ea'£5h entry is composed of one word ordered A through Z and 
contains address of unit, control block describing peripheral 
device^ list of mass storage descriptors or an expanded list 
of 26 file codes. 
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(1) indicates assignment to be held between tasks 

(l) indicates address is of ramdom storage list 

(l) indicates base address of an additional set. 
of 26 file codes 

Word 67-77 contains file codes ZA-Z1 reserved for syst^as usage.- 
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1.1.2. ACTIYITI ADDENDIM DEFINITION 

An activity is established by definition of an operating task and/or 
activity. The function allows a dynamic declaration of parallel or 
asyncronous paths through the task level code. Activity addendiams 
are used to control and register elibible control, paths. 

One Activity Addendum is formed upon initiation of the task. This. 
is used to start the task. One additional activity addendum will be 
formed for each activity registration or fork performed by the task. 
These activity addendums will be used (in conjunction with assigned 
storage modules) by the dispatcher as switching poings control running 
of the task and task fragments within the system. Activity addendum 
require IO3 words. 

The following describes the contents of the activity addendum: 

Word p Queue cell for central processor control will be used to 
link all activity addendums to the C. P. Control Queue. 
Also used to queue activities to hold or delay queues. 

Word 1 Storage module link used to link together all storage 
modules assigned to the activity. This points to the 
last module in the chain which will be used for first 
return of control. 

Word 2 Priority number of this activity (0-36). Used to control 

selection of highest priority activity eligible for control 
from 0. P. queue. Binary identify is number assigned by 
used for queued activities. 

Word 3 Address of the task addendum 

Word 4. Fork control. Bit 29 indicates if a JOIN has been given 

next 12 bits contain the number of forks this activity has 
made. Lower 18 bits used to link all forked addendum. If 
queue processing activity the lower ]5 bit contains the 
relative starting address. If other activity the word is 
zeroes. 

Word 5 Linking cell for all activity addendums associated with the 
task. 

Word 6 Contains the upper 12 bits of IFR and the relative index 
register of the activity.. " 

Word 7 Program lock register. 
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The following illustrates the chaining employed for task. addendum. 
Activity Addendums and storage modules used by the OMEGA to control 
a program. 
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The task addendum describes the task, code and contains all pointers to 
peripheral assignment descriptions used by the task code. The presence 
of three activity addendums implies three control threads through the 
program or parts of the program have been declared by the code at 
object time. Each activity addendum is normal registered to the dispatcher 
queue as an elegible point for program control providing for parallel 
or asynchronous processing within a program. This is in addition to the 
normal multiprogramming and/or multiprocessing of tasks within the 
system. 

The presence of two storage modules under activity addendums 1 implies 
the registered control thread has performed a service request to the 
OMEGA which has: 1) caused an additional service request by the activated 
OMEGA element which has called on a third element which is currently 
in control of the control processor, 2) the called for element was 
interrupted and requeued to the dispatcher, 3) the called for element 
has taken the activity out of the system unitl some disposing action has 
been completed for the request, e.g., l/O completion, freeing of. . 
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1.1 -.4 STOMGE MODULE DEFINITION 

The allocated storage module is a 20 octal word core area assigned 
to control interrupts or service requests of activities. The storage ■ 
module is always placed on an even core address so service routines 
(switcher, interrupt processor, handler) can take advantage of the 
memory overlap feature of the 494 • 

Entry Word Use 

18 bit link to previous storage modules if any or back 
to addendum. Use of control last in first out sequence 
of requests. 

1 - 18 bit address of the addendum this request is associated 

with. Stored in when module is assigned and used by 
servicing routines to find addendum. 

2 Internal function register store in at time of interrupt. 

3 Relative index register of the activity interrupted. 

4 Program lock register of the activity interrupted. 

5 Upper Upper 15 bits in the captured relative P a interrupt. 

Stored in after Store worker B is done. 

5 Lower Worker B*' registers store in at interrupt by store. 

6-13 Lower 15 bits of word 7 and 10 and lower 18 bits of words 
11-14 contain worker registers. Additional bits may be 
used by service routines for additional storage. 

14 Contents of A register at interrupt. 

15 Contents of Q register at interrupt. 
16-17 Additional storage for service routines. 
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Figure 1-3 
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2.0 Basic OMEGA System 

The basic OMEdA system is divided into two sections, the interrupt 
processors which answer all hardware and software interrupts and the 
related interrupt support routines which assist the interrupt 
processors in disposing of the interrupt. The second group, the 
interrupt support routines, include routines such as queue control 
and the dispatcher, , ' 

2.1 OMEGA INTERRUPT PROCESSORS 

The OMEGA interrupt processors for the 4-94- operating system 
shall operate on three distinct types of interrupts. These three 
types are a) task or task fragment generated interrupts, b) normal 
hardware and peripheral generated interrupts c) main frame 
contingency interrupts. 

2,1.1 Task or task fragment generated interrupts. 

These generated interrupts are either requesting service 
from a part of the operating system or are contingencies 
relating only to the specific task. The service request 
interrupts and the relative servicing routines will operate as 
an extension of the requestor. Task related contingencies 
interrupts usually result in the queueirig ox the contingency 
interrupt processor for subsequent control, 

'Service Request Interrupts 

Service requests are normally made by the use of the Exec 
return instruction and an associated packet or registers 
containing the parameters required to process the request. The 
only exception to this is the segment load that runs off of a 
■ guard mode interrupt. The organization of the routines which 
respond to the service request function is shown in 
figure 2-1. 

Each routine handling of a service request may itself make 
service requests for other functions to be preformed. Much 
of the communication between elements of 0M3GA is preformed in 
this manner; some service requests therefore, are internal 
to the system and will not be available to the general user. 
This organization contributes to the modularity and open ended 
design and allows the system to dynamically expand when core 
is available and contract as core is reqxiired by the user. 
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2.1.1*1 Service Request Routine 

This element of Omega is the interface by which an operating 
program communicates with and requests services of Omega, The • 
requestor is reactivated only when some' disposing action is com- 
plete. Result parameters are f^e turned to indicate non^ 
performance, normal completion or abnormal completion. • 

An . operating program requests service by. a sequence of 
instructions which submit a parameter packet appropriate to 
the request and interrupts to Omega. Since hardware guard- 
mode is enforced against operating tasks, the special 
executive entry instruction is used to submit a request. 
This instruction causes an interrupt and includes a 15 ' 
bit field identifying the function requested. 

Exec return instruction 



29 , 15 


U 12 


11 





7 7 5^0 


EXEC 
CALL 


Parameter to Servicing 

Routine 



where EXEC CALL represents the number of the resident EXEC 
function required to process or schedule the request and 
are as follows: 

Task Control and Miscellaneous Service Functions. 

1 Input/Output service request at the packet level, 

2 Contents supervisor, schedule request for a drum based service 
routine. 

3 I/O cooperative control, process primary and secondary 
Input/Output requests. 

4.- Core allocator, responsible for allocation and deallocation 
of core storage, 

5 Common subroutine linkage, responsible for establishing 
linkage between a common subroutine and its caller, 

6 Reserved for system use 

7 Reserved for installation usage 

The lower 12 bits of the Exec return instruction contain ' 
additional parameters to direct .the servicing routine. 
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Upon detection of the Exec return interrupt the* service request 
routine preforms the following functions for all Exec returns with a ' 
non-i'ioro oporoDfl. 

, All transitory registers (A, Q and worker B registers), IFR 
and the captured relative P will be stored in a storage module- 
that contains the activities PLR and I^IR. This storage module 
is then linked to the activity addendum through the storage 

module linking cell. 

, A new storage module will be acquired from the unallocated 
storage module chain and interrupt lockout will be released. 

• IFR, RIR and PLR will be set to the values for the Basic Exec 
routine responsible for handling the request and these values 
will be stored in the new storage module. 

. Program control is switched to the called basic Exec routine 
with the "A" register containing the IFR value (with the Exec 
call) and the "Q" register holding the. Activity Addendum address. 
(The assigned storage module can be found from storage module 
link cell) 

The servicing of the standard requests by the primary service 
functions are explained in the related individual section. Only 
the special service functions preformed by the Basic Omega system 
are explained in this section. 
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Special OMEGA Service Functions 

Because many OMEGA routines need special functions for. 

queueing and switching and do not have direct access 

to the queue tables and storagie area, a special OICBGA- return 

will be used by secondary OMEGA routines to request service 

from the basic OMEGA system. This return may only be 

used by OMEGA routines and is not allowed to worker programs, 

7754.0 00000 

with the parameters and service request number in the A and 
Q registers. Service request number is in A lower. 

The servicing routines will operate either interrupts 
locked out or logically locked out. , , ■ 

IDLE Service request number is zero 

This entry makes a direct entiy to the • dispatcher to select 
the next eligible task or task fragment for central 
processor control. 

Queue Control 

Queueing of tasks or activities to be performed is a 
major function of OMEGA. Besides the requirement for 
queueing at the occurrence of an interrupt, many of the 
servicing routines will require queueing functions to return 
control to worker programs, queue other functions to be 
performed, and queue themselves if requests must be delayed. 
A common queue control routine will be employed to 
perform the functions. 

Queue .Control can be referenced by servicing routines by 
an EXEC return instruction. The call is for an immediate 
function to be performed and will be performed with interrupts 
locked out or a logical lock imposed to protect over 
queueing or double referencing of the queue tables. 

Central Processor Queue 

The GP queue is the queue that directs the use of central 
processor control. Any routine that is eligible for 
control (and not currently in control) is listed on the 
ready queue. Servicing routines are required to have placed 
on the C. P. queue requests that have been completed. Other 
functions also are required to place entries on the C.P. queue 
(i.e., Program load to start program, etc.). 
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o. r, queue wn:n idle 

This group places activities on the C.P. queue and does not ■ 
require return of control. An entry to the dispatcher 
will be made after queue control has performed its task. 

Current Activity at its priority Service request number is 1.. 

Queue the activity currently running at its registered 
priority and exit to switcher. May be used to return 
control to worker upon completion of a service request. 

Current Activity at priority X Service request number is 2. 

Same as number 1 except the priority is defined by the 
upper 5, bits of the Q register. Useful to displace routines 
for a turn through the dispatcher. 

Addressed activity at its priority. Service request number is 3. 

Queue the activity addendum addressed by the lower 17 bits 
in Q register at its registered priority. The Q register 
contains a 17 bit absolute addendum address to go on the 
ready queue. Priority will be taken from the addendum. 

Addressed activity at a specified, priority. Service 
request number is 4. , 

Same as number 3 fexcept the priority is isupplied as an 
additional parameter in the upper 5 bits in the Q register. 
Useful to displace routines or have them gain control at 
a priority other than that , assigned to them, 

C. P. Queue with return of control.. 

This group places activities on the C.P. queue but wishes 
return of control for subsequent processing. Control will • 
be returned immediately following the EXEC Return after 
the queueing function has been performed. Subsequently 
an idle entry must be made to allow the queued routine to 
get control. Current activities cannot be queued with return' 
of control because no qjueue cell link would exist for 
interrupt queueing. . • ' 

Addressed activity at its priority. Service request number 
5. 

Same as number 3 except return control after queueing. 
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Addressed activity at a specified priority. Service 
request number 6. 

Same as number 3 except priority is supplied as a parameter 
in the upper 5 bits of the Q register and control 
is retxamed after queue ing. 

Switch Functions 

Switch functions are used by I/O control, contents super- 
visor, common subroutine linkage and RT/Comm control to 
switch control from itself to a routine being activated and 
to gain subsequent return of control. 

Direct Switch 1 Service request number 7 

Reset RIR and give control to the address specified 
by RIR. Qi^register contains a 17 bit address of the , 
RIR to reset, to. 

Direct Switch 2 Service request number' 10 

Reset IFR, RIR and PLR and give control to the address 
specified by RIR. Q register contains a 17 bit address 
of the list. Where IFR RIR and PLR are stored. 

Direct Return A Service request number 1T. . 

Reset and return control to the primary exec routine 
whose identity is contained in Q lower. Q' contains 
one of the following numbers. ^ ■ .', ' , •• 



"1 

"2 
no 

"4 
"5 
"6 
"7 



to return to I/O Director 

to return to Contents Supervisor 

Not Applicable 

Not Applicable 

to return to Common Subroutine linkage 

Not Applicable 

to return to Real Time Control ■ 



Direct Return B Service request number 12 

Deallocate last/ SMOD on current activity addendum arid 
return control to it. Used to return control to worker,, etc, 
without going through switch routine. 
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POP ' Service request niimber 13 

Compliment of Push, Remove from chain and queue 
for return of control the indica"Csd activity addendum. 
Control will be returned to requestor upon completion. 
The Q register contains the address of the chain cell 
for FIFO sequence or it is the address of the entiy 
in the chain immediately before the one the requestor 
vants popped. 

Initiate ISI I/O Service request number is 14- 

This request comes from the format or with the Q 
register containing the address of the SMOD with. all 
parameters in it. These parameters include channel 
number, queue placement etc. 

Initiate ESI 1/6 Service Request number is 15 
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This request asks for the formed task addendum whose 17 bit 
absolute address is contained in the Q register to be added, 
to the chain of task add^ndums. The new addendum will.be 
linked to the task addendum currently in control and all 
other links will be updated. 

De-link Task Addendum. Service Request Number 17 

This request asks that the task addendum whose Job number 
is contained is. in the Q register be removed .from the chain 
of all task addendums . 

Switch Control Thread. Service Request Niamber 20 

This request asks tha-o the 17 bit Activity Addendum address 
in Q be switched to the task addendum address by the Job 
number contained in A upper,, that the indicated addendum be 
queued for control and an idle entry made to the dispatcher. 
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2.1,1,2 Task Contingency Interrupts. 

Task contingency interrupts are hardware interrupts that impact 
only on the related task and do not prevent the rest of the 
system from continuing. These interrupts include: 

Illegal Instruction 

This interrupt is caused by attempting ' to execute a 00 or 7700 
instruction code or attempting to execute a privileged instru- 
ction. Standard systems action is to abort the offending 
task. Tasks may, however, pre-establish an illegal instruction 
recovery routine. If established, the routine will be eligible 
for control under the offending activity addendum. Additional 
parameters besides transitory registers will be available to 
the routine. 

Program Protection 

This interrupt is caused by a program trying to read, store or 
jump outside its assigned area. With the exception of the 
informal segment call (which is explained in segmentation) 
the task will be aborted with information about the violation 
logged by the abort routine. 
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Timeout 



Floating Point Interrupt 



Test and Set Interrupt 



2-11 



2,1.2 Normal Hardware and Peripheral Interrupts 

These interrupts usually result in. the execution of waiting 
functions and generate a request for seirvice. The servicing 
of the interrupts will operate at varying priorities. They 
may have been established from the requesting task, priorities.. 
of waiting functions, optimum peripheral usage or other system 
considerations. Disposal of the interrupt will usually restilt 
in the removal of an activity from a delay queue and placed on 
the central processor queue for subsequent control. ' 
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2.1.2.1 Internally Specified Index Interrupts 

Control of ISI interrupts is handled by two routines. ' The 
ISI processor and the channel control block processor. 

ISI Pi^'ocessor 

The ISI processor is activated by the ISI interrupt and 
runs "with interrupts Lock out. If the interrupt was an 
external interrupt, the interrupt word and both input 
and output BCRs are save (these are not saved on a 
monitor interrupt) . The next function queued on the 
interrupted channel control block is then executed. 
Upon completion of the execution of the I/O commands, 
the ISI processor checks to see if the Channel Control. 
Block processor can be run. If it cannot, because of a 
higher priority routine in control, the channel control block 
is marked as needing processing and a return to the point 
of interrupt is made. The CCB must then be processed 
in it priority to the rest of the interrupt processing 
before control can be returned to any worker program. If 
no higher priority routine is in control, such as ES'H . 
processors etc., the Channel Control Block processor will 
be entered directly from the ISI processor after saving the 
interrupt point. 

Channel Control Block Processor 

The Channel' Control Block processor is a routine that 
operates logically non-interruptable and prepares the 
CCB for the next execution and processes the previous 
function and queues interru^'^t analysis if neGessary* 

Channel control blocks are used to control input/output 
operation for all standard peripheral channels. One CCB 
is set up for each channel containing standard peripheral 
hardware, A table of addresses called,; CCB table is 
kept to be able to access the CCB by chaianel number* The 
CCB is shown in figure 2,1-1. 
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CHANNEL CONTROL BLOCK 



Label Ref-Upper or Whole 



Label Ref -Lower 



KGCSXTINT 




1 
2 

3 

4. 

5 

6 

7 

10 

11 

12 

13 

U 

15 


|29 


EXTERNAL INTERRUPT STOPuAGE 







KCCINBSR 


j29 


INPUT BCR AT KXT INTERRUPT 







KGCOUTBGR 


29 


OUTPUT 


BCR AT EXT INTERRUPT 







KCCWAIT 


J29 WAIT FOR 15 U TEST EXT INT 
INTERRUPT INDICATOR INDICATOR 





KCCTEST 


KCCITIPE 


|29 TYPE OF INTERRUPT 15 U QUEUED INTERRUPT 
1 INDICATOR INDICATOR 





KCGIQUE 


KCCPROC 


129 

1 CCB PROCESS 


15-U 
IND. ! CHANNEL LOCKOUT: IND 





KGCLOCK 


KGCSWIND 


gS SWITCHING 
1 INDICATOR 


15 |U 


5 CHANNEL 

wm 


KCCCHAN 


KGCIOC-CTL 


|29 [28 




18 h7 ADDR. OF LAST I/O 
! GROUP EXECUTED 









129 J28 

! f 




18J17 ADDR. OF NEXT I/O 
5 GROUP TO EXECUTE 







KCCCEMCTL 


[29 

i 




18 17 

CEM CHAIN 







XCCINTADDR 


!29 




18J17 • 

! INTERRUPT STORE ADDR. 







KCCUCBC 


129 

1 




18117 

. ! UCB CHAIN 







KCCFUNC 


29 




18 17 ADDR. OF FUNCTIONAL 
CHAR. OF CHANNEL 







KCCLLOCK 


29 




18 17 ADDR. OF LOGICAL 
LOCK TABLE 













figure 2,1-1 
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Explanation of Entries in the channel control block. 
Word # 

Used to temporarily store the external interrupt before 
it is moved to the GEM. Not used on monitor interrupts. 

1 Contents of the Input BCR at external interrupt time. 

2 Contents of the Output BCR at external interrupt time, 

3 Upper half is wait for interrupt indicator and is set or 
cleared depending on the exit used from the CM. Lower 
half contains an indication of a by-passed I/O sequence on 
an external interrupt. 

4 Up-Der half is interrupt type indicator 

00000 = External 77777 = Monitor 40000 = Error (Time OUT, 

Parity errors) 
Lower is used to indicate an interrupt has occ\irred when 
the channel was logically locked out. 

5 Lower half is channel lock out indicator and if set it 
means the CCB has not been updated to accept the interrupt, 

) Upper half is used to indicate the channel has to be processed 
before OlffiGA goes logically interruptable . 

6 Switch indicator - if clear switch to analysis on high 
priority, if set return to interrupted activity unconditionally. 
Lower half contains the channel number. 

7 Address of last I/O group executed used to cohtrol return 

to analysis. Bit 29, if set, indicates there was no previous 

function. 

10 Address of next I/O group to execute. Used to execute 
next I/O sequence. Bit 29, if set, indicates there is no 
new function to execute. 

11 Channel executor module chain control word. 

12 Address to move interrupts for device handler analysis. 

13 Address of first unit control block in the UCB list for this 
channel, 

14. Address of the functional description of this channel. Used 
'uj device handlers for function and interrupt codes, etc. 

15 Address of Logical Lock List for this subsystem,. 



2-15 



The CCB processor upon completion of updating the CCB 
enters an interrupt support routine that check for other 
interrupts in order of priority and switches control to the 
appropriate processor. 
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1.2.2, SSI Interrupt Processing Routines 

The function of the ESI Interrupt Processor is to answer ESI 
interrupts, identify the interrupting ESI, re-establish activity 
on the l/O channel, provide an additional communication buffer 
if required, and perform any other functions as pre-directed 
by the Communication Handlers. The ESI Interrupt Processor is 
distinct from, and has priority over, the ISI Interrupt Processor. 

The SSI processor consists of three routines: 

•The ESI Interrupt Answering Routines 

•The SSI Interrupt Processing Routine 

.The ESI Buffer Chain Control Routine 
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Interrupt Answering Routine 

Function - The ESI Interrupt .mswering Routine identifies 
terminating ESI, r3-establishes activity on the 
interrupting chanr. 3I and insures an orderly 
path through the ESI Interrupt Processing Routine. 

ENTRY - Entry to the interrupt answering routine is from 
the three ESI interrupt entrance locations. 

EXIT - The routine exits either to the ESI Interrupt 

Processing Routine or to the point of interrupt . 
(Exit to the point of interrupt occurs only 
when the ESI or ISI Interrupt .Processor has 
been interrupted). 

Operation - The ESI Interrupt Answering Routine operates 

in the Executive Mode and with interrupts locked 
out (the result of being entered from an interrupt) , 
Three distinct entrances are required because of 
the different manner in which the input monitor, 
output monitor, and external ESI interrupts must 
be handled initially. 

The input and output monitor entrances must 
capture the terminating ESI and then re-establish 
channel input or output, activity. If the address 
contained in the terminating ESI points to a 
previously defined buffer, the buffer is established 
(see Section 8.3) . The external interrupt entrance 
need not re-establish the channel. 

The routine now increments the ESI interrupt 
count in the CTM Control Block Table (Figure 2.1-3) 
and accesses the location in the table corres- 
ponding to the terminating ESI. This location 
contains the address of the CTM Control Block, 
This Control Block, explained in Section 8.2.1,' 
contains control information' for- the line. The 
section of the Control Block shown below is 
used by the answering routine to store information 
for the ESI Interrupt Processor. 




INPUT MON. CNT. I OUTPUT MON. CNT 



ESI INPUT BCW 



ESI OUTPUT BCW 



ESI EX. INTERRUPT WORD 
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The Answering routine increments either the input 
or output monitor count depending on the type of 
interrupt. If the count was zero the contents of 
the terminating ESI location is stored in either 
of the next two words depending on type. If an 
external interrupt occurred, the word on the line 
is stored in the last word shown. The contents of 
the terminating ESI enables the Interrupt Processor 
to examine the chain links of the communication 
buffer to determine whether .or not a new buffer 
must be obtained . The input and output counts are 
used to determine the number of interrupts on this 
ESI when a buffer chain has been previously set up 
by the handler. They are of value only when 
extremely small buffers have been specified or when 
an overload condition exists. 

After storing the proper controls as described above 
the Answering routine switches from the Executive 
mode to the Worker mode, enables interrupts, and 
passes control to this ESI Interrupt Processing 
Routine. If the Interrupt Processor was already in 
control when the ESI interrupt occurred, control is 
returned at the point of interrupt. 



ESI Interrupt Processing Routine 

Function - The ESI Processing Routine functions to obtain or 
release communication buffers from the core chain, 
and informs the appropriate communication handler 
(via the QBEF function) of the interrupt if previously 
instructed to do so by the handler. 

ENTRY --Entry is from the ESI Interrupt Answering Routine. 

EXIT - Exit is a return to the ESI Interrupt Answering 
Routine for the release of the logical lockout 
and for switching if necessary. 

Operation - The ESI Interrupt Processing Routine operates as an 
extension of the Interrupt Answering Routine, The 
difference between the two routines is that the 
Answering Routine operates with ' interrupts lockout 
while the Processing Routine operates with interrupts 
enabled, but in a logically non-interruptable mode. 

Upon gaining control from the answering routine the 
processor interrogates the indicated CTM Control Block 
to determine the type of interrupt , If an input 
monitor interrupt occurred the routine checks the 
.Input Buffer Link of the last communication buffer 
to determine whether or not a new input buffer is needed. 
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If the link is not zero the Ansering routine has 
already established the. link as the new buffer. 
If the link is zero the processor obtains from the 
buffer chain an input buffer of the size stated in 
the 024 Control Block and places the BCW in the appro- 
priate ESI address and also in the InPut Buffer Link 
position of the terminating buffer. The processor 
then examines the input monitor section of the 
"Interrupt Control" word in the CTM Control Block to 
determine the next course of action. The possible 
alternative are: 

. QBE? the handler indicated in the CTM Control Block 
conveying the addresses of theCIM Control Block and 
the terminating buffer. 

. Do not QHEF the handler. This means that the 
handler is scanning the buffer on a certain time 
interval and is not interested in the monitor 

interrupt. 

. Send a "Look for Sync" external function to the 
CTM (applicable only into synchronous CTM's. 
This option may be used in combination with 
either of the above. 

Upon receiving indication of an output monitor 
interrupt the processor examines the Output Buffer 
Link of the terminating ESI and the output monitor 
section of the "Interrupt Control" word. The options 
are: 

» Return the terminating output buffer to the 
buffer chain (would not be used if the same 
message was being sent to more than one CM) . 

. QBE? the handler on every output monitor interrupt 
conveying CTM Control Block and buffer. 

. QREF the handler only when the Output Buffer Link 
of the terminating output buffer is zero. Thus, 
if the message is broken up into a chain of buffers, 
the handler will be notified only when the last 
buffer of the chain has tenninated. 

Upon receiving indication of an external ESI interrupt 
the processor will QREF the handler indicating the CM 
Control Block the interrupt status, and the contents 
if the input ESI address at interrupt time. Buffer 
chaining may be performed. As an option the "Interrupt 
Control" word may specify that a "Look for Sync" function 
be sent to the CHi at this time. 
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After processing an interrupt or series of interrupts 
(as determined by the count in the CTM Control Block ' 
the processing routine clears the indicators in the 
CTM Control Block and checks the interrupt counter in 
the CTM Control Block Table for other ESI interrupts .;• 
which may have occurred while the Forces sor was operating. 
If no other interrupts have occurred the Processor returns 
control to the Answering Routine for switching, 

ESI Buffer Chain Control 

The ESI Buffer Chain Control Broutine may properly be considered a part 
of the ESI Interrupt Processing Routines since it must be accessed directly 
by the Interrupt Processor for fast acquisition of input buffers. The 
routine must also be available to the communication handlers for acquiring 
and releasing ESI input and output buffers. The handlers cannot enter the 
routine directly and, therefore, must use an EXECUTIVE RETUM instruction. 
In view- of this dual usage of the routine, the description of this routine 
along with the ESI buffering scheme will be given in Section 8.0, Coimmini- 
cation and Real Time Control". ' ' 
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CTM CONTROL BLOCK. TABLE 



yiPLX GLT PRIOR 



INTERRUPT COUNT 



00 00-01 
00 02-03 



I 29 I8h7 

PRIORITY 1 CiM CONTROL BLOCK 



00 
01 



76-77 
00-01 



NN 76-77 



L 



CTM CONTROL BLOCK 




FIG. 2.1-3 



The CTM" Control. Block Table points to the core location of the 
CTM Control Block associated with the corresponding ESI. There is 
one entry in the table for every ESI in the system. If there 
is no CTM at that location or if the CTM has not been acquired, 
the lover 18 bits of that location are zero. The first word of 
the table is a count of the number of ESI interrupts to be 
processed. The remainder of the table is arranged according to 
ESI address. The correct location in the table is referenced 
by subtracing the base address , dividing by 2 (right shift 
one bit) , and adding the table base plus one. The upper twelve 
bits of each table entry is an increment to another location in 
the table . The sequential arrangement of these increments defines 
the processing priority of the ESI interrupt. 
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2,1,2,3 Clock Interrupts and Clock Control 

Time and clocks are controlled by the table shown in 
figure 21-2. The entries in this table are 

Word Number* 

A 30 bit 24' hoiir clock maintained from the real 
time clock interrapts. This, clock contains a count 
of the . number of 200 microseconds intervals that' 
have elasped since the previous midnight or other' 
arbitrary startling time to the time of the last 
Real Time clock interrupt. 

1 Contains the last value set into the real time 
clock (current time of day to 200 hrs can be 
calenlated by the difference- of the ETC and the 

. last KTC setting plus the value in -word zero). 
This value is set from the different between current' 
time and the time to activate the next entry on the- 
list. ' , 

2 Contains a chain cell for all activities linked 

to the time delay table. Last word of the addendum. 
is used to hold the 24 hour time to reactivate 
the activity, 

3 Contains a chain cell to link all activities to 

be activated on gross time of the day clock. . Clock- 
time is in the last word of the addendum. 

Notiez Chains linked to words 2 and 3 are ordered 
according to relative activation time. 

4 Current date is maintained in word 4 'in the form 
YY DDD 
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TIME CONTROL TABLE 




1 
2 
3 
k 



^30 Bit 24. Hour clock 200 us granules 
(Time at Last Timer Interrux)t) 





29 18 
Zero Fill . 


17 

Last ETC Setting 





29 


17. 

• TiTning Chain Cell' 





129 


17 

Day Clock Time Cdll 





29 

DATE 






Figure 2.1-2 
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2 . 1 .2 , 4- Syncronization ' Interinipts 
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2,1.3 Main Frame Contingency Interrnpts 

These interrupt routines such as parity error and power 
loss will operate at highest priority until recovery 
procedures are effected and it is determined that 
the system can continue to run or a system abort is 
necessary with its own recovery prooejiares. 
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2,1,3.1 Parity Error Interrupts 
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2.1.3.2 Power Loss 
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2.2 interrTipt Support Routines ■ 

Interrupt support routines are those not directly^ related to 
interrupt processing but are necessary for switching and basic 
control of the system. 

2.2.1 C.P. Queue Table Definition . 

Two tables are required to control the C.P. queue (see figure 4) • 
Each of these tables is 4-0^ words.' There is one entry for each 
possible priority (0-36) and one for Exec fiinctions to be run during 
idle time (core compaction, Drum compaction, etc.)-. Each entry in 
•Table A contains the 17 bit addendum address of the first task or 
task fragment eligible- for control in the associated priority 
group. (These may be completed service requests, interrupted 
activities, or programs just loaded and ready to run..) If the 
contents of any entry in Table A is zero it indicates that there are 
no activities eligible for control in the associated priority 
group. Table B entries contain the 17 bit addendum address of the 
last task or task fragment eligible for control in the priority group 
indicated by the position within the table. Within the activity ■ 
addendum of the task or task fragment addressed by the entry in 
Table A is an address linking the first addendum in any priority group 
to the next aadendum in the chain. This linking continues until 
the end of the chain of addendums is reached and this last addendum 
address appears in the corresponding priority entry in Table B. 
As task or task fragments become eligible for control, the entries 
in Table B . are used to get to the last addendum, the link is made 
and the entry in Table B is updated to point to the new addendum 
address added to the C.P. queue chain. The Switcher is used to provide 

thp f.T»fl ns-Pp-r nf* n.nirif.-ml +.n •i'.ha fn T«eT. ol -i crn "hi c» +.ia«'lr ot« +.ft.<a"lr ■P-naamQr\+. 

The Switcher inspects entries in Table A, selects the next candidate, 
updates the entry in Table A to the next addendum in the chain, 
and transfers control to the selected activity. The exec functions 
entered in the last table location are only selected if no task or 
task fragment is eligible for control. 
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EMDI QUEUE CONTROL .TABLES 



Priorityj^ 




r 



1 



4 

32 

33 
34 

36 

3d37 



list Entry 
[priority ^ 



1st Entry 

Priority 1 



lf=0 No Entries 
this Priority I 




'1st Entry 
Priority 36 



:1st EXEC FUNC I 
jrO BE HUN iSbE I 
I Qua ^ v\(u 1, o u.e I 



36 i 



37 



Last' Entry 
Priority ^ 



Last Entry 
Priority 1' 



Last Entry 
[Priority 36 




'LAST EXEC FUNG 

Jto be run during 
[idle 



Figure 4 
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Storage modules are used to contain register settings for a control 
thread (activity) upon execution of Exec return or lost control and re- 
enter point (LCE) due to interrupt. 

Because of the need for storage modules to run tasks and tasks fragments, 
some of the available core storage will be dedicated to OMEGA for 
storage mod-ales. This core will be acquired from core allocation who 
is responsible for assigning and keeping track of all available core. 
The number of modules needed is dependent on the systems configuration 
and activities registered with OMEGA for running. 

The core that OMEGA acquires will be placed in an unallocated storage 
r^odule chain. Each module will have a link associated with it (see 
figure 1-4) that will poinu to the next available module in the chain. 
The control table for this chain is shown in figure 1-5. The first 
address held in this four vrord table is the address of the first avail- 
able storage module. Each storage module then has the address of the 
next available modiile. The last module has zeros in the link indicating 
the end of the storage module chain. 

In addition to the storage module chain, OMEGA will have one extra module. 
Each time that OMEGA leaves the Exec mode and allows interrupts and 
service requests the address of this available modiale will be held in 
one of the seventeen bit Exec B registers. If a service request or an 
interrupt requires the use of the module, it will be linked to the 
addendum and a new module will be obtained from the storage module chain. 
As service requests and interrupts are disposed of, the modules that 
were assigned will either be put back in the storage module chain or will 
be used as the available module OMEGA holds when giving control to th© 
activity of non-Exec mode service routine. 
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UNALLOCATED STORAGE MODULE 



29 




UNALLOCATED LINK 







RESIDUE 
7 ■ 


INFORMATION 





If Unallocated link is 
zero, this is the last 
available module. Non- 
zero is the address of 
next module in chain. 



13 
U I 

. i 

! ■ 

'^ I 

17 1 



KSCNASG 



KSCNOUT 



Fisrure 1-4. 



STORAGE MODULE CHAIN CONTROL 



29 


18 1? . 

SMOD CHAIN CELL 





29 

NUM of SMOD'S 
' Assicrned CHAIN 


15 U 

NUM of SMOD'S 





29 

NUM of SMOD'S 

in use 


15 


U 
■Max Nim ever 
in use 





29 


15 


Num of entries 
in Free Core 






KS^xODCHAIN 
KSCNLEFT 
KSCMOUT 
KSCEFCHAIN 



Figure 1-5 



Note: Last two words are used to gather statistical information 
about SMOD uses. 
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2.2.3 Channel Control 

Due to a n-umber of enhancements in 494- hardware operating -under 
control of OMEGA the peripheral device handlers will not be 
allowed direct control of the input/output logic. The list 
below includes some of the reasons necessitating this change. 

1) Common interrupt locations for all channels 

2) P.equired use of channel select register 



3) Peripheral may be attached to CPU -through IOC, normal 
channel or both,. 

4) Non-standard device handlers 

5) Modularity within OMEGA 

6) Increased speed of response at occurence of interrupt to 
submit next function of channel. 

Without direct control of l/O the device handler will be required to 
communicate with the routine that will control all input/output 
operation. The communication will be performed through a list 
of Input/Output Command Words. The format and description of the 
command word is shown in figure I. The device handler will create 
the command words, function words for the specific peripheral, 
and buffer control words. This information will be passed to the OMEGA 
subroutine responsible for all l/O operation through register 
A, Q, and B7. 



Wnen control is assumed, B4 has the 17-bit address of the storage 
module wherein the registers A, Q, and 37, containing pertinent 
information, are stored. 

STOEED in SKQD for use of OEM FOEMATTSR: 

A Contains 17-bit address of the CHANNEL EXECUTOR M3DULE 
previously formed, after which present OEM is inserted in 
chain. If A29 is set, negative control will be returned 
immediately after queueing with no return of control upon 
execution, 

Q Number of command words in upper and channel number of 
l/O in lower. 

B7 17-bit address of the word used by Device Handler; used for 
priority nimber, request ordering number, etc. 






B7+1 INTEREUPT STORE ADDRESS 
B7+2 First coBsnand word in list, 
Format of EXEC RETUR]^ instruction is 7754-0 0000 
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INPUT OUTPUT .COMMAND WOKD FOHMT 
2 3^ 5 6 7 



P9 27 



r 



DEF 



26 
C 



25 

W 



24123 



22 18 

COUNT 



17 

ACER. OF FUNCTION OR 
BCW LIST 



Explanation of Fields 

1) DSF Bits 29-27— Definition Field 3 bits. 



000 
001 
010 
011 
100 
101 

110 

111 



Send terminate for channel logic. 

Not used. 

Activate buffer with monitor. 

Activate buffer without monitor. 

Send external function word to peripheral. 

Read time and send external function put time in Input 

BCR of interrupt store. 



2) C Bit 26 Chain indicator 1 bit 

1 Chain this command word with next ccamiand word 
0. Do not chain this command word 

3) W Bit 25 Wait indicator 1 bit 

(Used only if chain bit is not set) 

1 Wait for interrupt 

Do not wait for interrupt - none expected. 

U) I Bit 24 Input/Output indicator 1 bit 

1 Output from CPU to peripheral 

Input from peripheral to CPU 

5) T Bit 23 Test for external interrupt indicator 1 bit 

1 Test for external interrupt before executing l/O 
No test. for interrupt. 

If the test. bit is set a test for external interrupt will be 
preformed before executing' the l/O defined by this command 
word group. If the previous interrupt ' was an, external interrupt 
bypas9 the execution, of this l/O command word group. 
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6) COUNT 



Bits 22-18 Count field 5 bits. Five bit count of the. number 
of entries in the list specified by the list address. 



7) ADDR 



Bits 17-0 Address of the list 18 bits. Absolute address of the ■ 
list associated with the conmand word. The lists may be functions 
words for peripheral devices or buffer control words. Not used 
with terminate. 
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2.2.3.1 GKAKNSL EXECUTOR MODULE 

The Channel Executor Module (CEM) isja variable length core storage 
area used to queue and execute request through the hardware function 
executor. The core storage is dynaEiically acquired from the core' 
allocator. The CEM is constructed ;by the FORM/LTTER routine from 
the command word list and other information specified in A, A, and 
B7. This module is then queued to the appropriate GCB for sub- 
aaquent execution of the input-output coimaands. 

Explanation of entries in figure 5 

. Word number 







3 bit 29 
3 bits 0-U 



4,5 



Contains a 17 bit linking address to 
chain all requests to the CCB. 

Available for device handler use, e.g. 
Priority number, request ordering number. 

INTERRUPT STORE ADDRESS - where external 
interrupt and the contents of the B(Sl registers 
are stored at interrupt time. 

Mast be set zero to test positive to 
distinguish end of module. 

Number of words in the following l/O 
Group. Used to control execution. 
Includes l/O instructions, EXIT Jump, 
and associated data words. 

Variable number of input-output instructions • 
to be executed. All I/O instructions must 
be modified by index register B7. Address 
portion is an increment from the number of words 
entry to the associated l/O Data word, i.e. If 
word 10 is associated with l/O instruction at 
word 4", the increment would be 00005. B7 
would contain the address of the # words 
entry. 

Exit instruction. This is a jump instruction to 
leave the CCB. The exit jump' is set up depending 
pn the type of processing required. 



2.2-9 



Word Number 

9,10 Data words associated with previous input- 

output instmiction, i.e« Function word, 
BCW, etc. 

11-14 . Another group of l/O instruction data words 

and associated control information as 
explained above. 

29 

x+2 Second word in GEM- variable placement. 2 - 

is set to 1 to test negative for end. Bits 0-1 6 
contain a 17 bit addendum address to activate • 
upon completion of the l/O functions, 

x+3 Last word in OEM contains the count of the 

number of words to release back to free core 
and the address of the GEM. use to release the 
cor© upon completion of the l/O sequence. 
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CHANNEL EXECUTOR MODULE (494-) 



10 
11 
12 
13 
U 



129 
1 


18 


■17 


CCB LINK 





•?29 


DEVICE HAI^^DLER USE 







129 


T^fPTTOT? TTOT* C T'P.'Q ":? A riT^-0 1? 


CO 






I 29 



15|14 

I No. of words in group 



129 



I/O INSTRUCTION 



29 



117 1$|U 

7 1 i^ gf (^ e^ xi 



I/O INSTRUCTION 



17 15 
7 



U 



29 



gf gf X?. 



EXIT JUMP 



i 29 



DATA WORD ASSOCIATED WITH l/O 



29 



DATA WORD ASSOCIATED WITH l/O 







I 29 



15 14 

I No. of words in group 



! 29 



I/O INSTRUCTION 



h7 15114 

I 7 I (^ gf X^ 







29 



EXIT JUMP 



29 



DATA WORD ASSOCIATED WITH l/O 






Group A 

(example) 
X^ = 4 

X2= 5 



Group B 
( example) 

X3=3 



X 



X+1 



29 



DATA WORD ASSOCIATED VJITH l/O 



29128 



X+2 I 1 



18|17 

\ ACTIVITY ADDENDUM ADDR. 



29 



X+3 



WORD COUNT 



18f17 



OEM ADDRESS 
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The command words are formatted in a list - and necessary data and 
information concerning the necessary operations are .stored in the 
registers. On occurence of the exec return instruction the registers 
are stored in a storage module and the address of the module is 
furnished in B4. 

The first step is to get core allocated for the formation of the module. 
A scan is performed on the command word list checking the number of 
data words associated with each command word and the occurence of a 
chain indicator to determine the total number of words necessary. The 
routine then puts the number of locations necessary into Q and the 
number of the variable length chain into A and makes an exec return 
to get the needed core allocated. 

Upon return of control, A will have the address of the first location of 
the allocation. The routine then stores data into the module and begins 
the formation of the module. The indicator bits in the command words 
are tested to determine whether a terminate, an activate buffer, or a 
send external function instruction is ■ specif ied . The instruction is set 
up and the address and count of the data words is stored in the lower 23 
bits of the word until it can be processed later. Command words are 
examined and l/O commands set up until the end of the first subgroup of 
l/O commands and the necessity of a wait or no wait test. . A jump is set 
up to either the wait or no wait location for use during execution. The 
routine maintains a count of the number of l/O instructions to determine 
the increment to be stored in the lower of each l/O instruction. 

After the jump has been established, the routine retrieves the address 
and count of data words from each l/O instruction, masks in the necessary 
B7 indicator, inserts the increment, and links the data to' its associated 
l/O instruction. It continues to format the subgroups until the supply' 
of command wrods becomes exhausted. 

It then sets a one bit in 2^ in the first location after the last data 
word to signal the end of instructions and stores the word count and 
GSM address in the last word. The routine then makes a check to see 
if the command word routine wants return of control. If it does the ' 
activity addendum address is set to zero. If not, the activity addendum 
address is retrieved from the SMOD and stored in the next to last 
address. An exec return gives control to the GEM initiator where the 
module is queued or initiated depending on the condition of the GEM 
chain. -^ 
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3»0 ' Input/Outf^ut Control 

3.1 General Description 



The general sequence of events required to perform an 
input/output request are described and illustrated as 
follows: 

. An operating activity performs an EXEC return instruction 
specifying a function code and with B7 set to the address, 
relative to lower lock limit of requestor, of the packet 
describing the request. 

. Upon receiving the EXEC return interrupt a storage module 
is allocated and control passed to the l/O Director. 
The I/O Director retrieves the file code from the packet 
and locates the cell in task addendum for the code. 

. If the request is for random access storage, the assignment 
cell contains the address of the storage list from which 
the logical drum address is mapped to the channel address. 
Once channel address is formed it is checked for end-of-file, 
lock list options are performed, and the address of the unit 
control block retrieved. If the request was for a unit 
assignment, the file code cell contains the address of the 
Unit Control Block (UGB"! direp.tlv. 

_ ^ ,— — — ^^. 

. Upon determining tlCB the l/O Director retrieves free core to 
use as work area and switches control to indicated device 
handler. Device handler forms the requests into work 
storage, determines where on the channel queue the request 
should be placed to optimize channel usage and passes control 
to channel queue control which enters the request on the 
chain. The request will subsequently be processed by the 
Hardware Function Executor (See Section 2.2.3). 

. The Hardware Function Executor gains control from an l/O 
■ interrupt which activates the following sequence of events:' 
1 ) capture interrupted location and store contents of 
channel; 2) execute next function of the channel; 3) queue 
storage module for completed request which will eventually 
reactivate device handler; 4). ready, next queue request for 
execution; 5) return control or queue interrupted program 
as dictated by channel option. 

. Upon completion of the function by the Hardwa're Function 

Executor, the device handler ' s analysis phase is automatically 
schedule and activated.- The status word is analyzed and 
reformated, and control returned to I/O Director. The l/O 
Director releases free core obtained for request, clears. any 
indicated lock list, and requests the return of control to the 
requesting activity. 
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3.1.1 Random Access Storage 

When "fandom access storage had been assigned to a file 
code the list is required to cont.ain descriptors of the 

file. 



Word 


1 
2 ■ 

3 

5 

N 


DRUyi ADBHSSS 


Access storage from 

last assignment 




CH # OF WORDS 




DRUIvI ADDRESS 


Pointer from 


CH i- # OF WORDS 


Describe one 


task add. for 


LINK TO UGB . 


continuous area 


file code 


ADDITIONAL 3 WORD ' 
DESCRIPTORS OF 
CONTINUOUS AREAS 






1 LINK TO UCB 





Drum address is relative to beginning of channel, # of 
words are the rroniber of continuous cells from drum address. 
"Ch" is the channel number- of subsystem, and "Link to 
UCB" is the address of the Unit Control Block describing 
the device handler , 

Words 1-2 Describe .random access storage assigned but 
not required by the request. This area will 
be used to satisfy any expansions of the file. 

Words 3 - 5. Describe a continuous area of mass. storage 
assigned to the file.' ' Additional entries 
may be present to describe areas of mass 
storage which are logical but not physically ■ 
adjacent to one another. Last descriptor 
indicated by 2^^^^^ set to (l). 
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3.1.2 Unit Control Block (UG3) 

The UCB contains hardware and control information used 
by the l/O Director and the device handler. 



Word 



i HANDLER RIR 



TTPR TTT\T1^ 



P-TYPE 



CH/CH/UNi: 



CCB ADDRESS 



4. LENGTH OF. UCB' 
5 1 CORE MOD. SIZE 
6 
7 



N 



|# OF REQUESTS 
iTSET LOCATION 



[PUSH/POP QUEUE 




Word - contains RIR setting of device handler and 
is the implied starting address. 

1 — contains link to other UGB's on the I/O channel. 

2 - contains peripheral type and channel and unit 

number. 

3 - address of the Channel Control Block (CCB) . 

4- - number of words contained in the UCB and number 
of I/O requests currently queued to the CCB for 

this. unit. 

5 - minimum core module obtained by the I/O Director 

for the handler and "Test and Set" location used 
by the I/O Director to lock out the unit. 

6 - push/pop Link for queing requests to the unit. 

7— I'J— variable coxu-rol inforiLation 'used by t-he handlers 
(see Section 3.3 for individual handler usage). 
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Figure 3-1 
3.l4 



3.2 I/O Director 

The I/O Director consists of. three distinct routines: a pre- 
■ processing routine for the device handlers, a console handling 
routine, and a logical lock routine for mass storage. 

3.2.1. Preprocessing Function 

Purpose: To perform functions which are common to all 
handlers and coordinate and control the flow 
of l/O requests to the handlers.- 

. Entry:- One entry is from a worker program through anl 

Exec call to the Service Request Routine, Another 
entry is from the Device Handler at the completion 
of an I/O request. Entry parameters are: 

•"A" contains the Activity Addendum address 

• "Q" contains the lower of IFR at interrupt 
time (function code) . If Q is equal to 
zero the entry is from a handler; if Q 
is not equal to zero the entry is from 
a worker program. 

•Vfnsn entry is from a worker program the address 
(relative to PLR lower of the worker) of the 
associated parameter packet if required, is 
contained in the B7 position of the last Storage 
Module linked to the Activity Addendum, 

•When entry is from a handler the address of 
the associated Unit Control Block is contained 

in B$. 

Exit: One exit is to the Device Handlers for execution 
of an I/O request. Parameters are: 

•B4. contains the address of the Storage Module 
associated with the request. 

•B$ contains the address of the appropriate UCB, 

•Within the Storage Module indicated by B4. 
other parameters are stored; the lower of the 
IFR position contains the function code; the 
B7 position contains the absolute address of 
the parameter packet; the word following 
the Q register position contains the address 
of the core area obtained for handler use. 

Another exit is to the worker program at completion 
of the l/O request. Parameters indicating the 
status of the request have been placed in the 
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"A" and^ "Q". positions of the Storage' Module. 
These values will be contained in the A and Q 
registers when the worker regains control. 

Operation: Request Initiation Phase 

Upon gaining control form a worker program, the 
I/O Director loads B4 with the address of the 
Storage Module contained in the .Activity Addendum. 
This parameter is used both by the director and 
handlers. The function code identifying the' 
operation to be performed is then interrogated ' 
to determine the location of the file code (may 
be in B7 or in the parameter packet, see Section 
3.5.2). 

After obtaining the file code the Task Addendua 
location corresponding to the file code is accessed 
to determine the validity of the file code. If 
the file code is invalid a "No Assignment" 
(4JZf^j2i0»|2f52fj2ll^) status code is placed in the A-register 
position of the S-mod and control is returned to the 
worker program. 

A valid file code will yield the address of either 
a unxu v^cntircju ^j-Gck. or a iwanuom A.ccess iw>ucrage 
List. This value is then entered into B$ to be 
used by both the director and the handlers. 

If the file code pointed to a Random Access List 
and .the function code indicates rewind, rewind 
with interlock, write end-of-file, or erase 
operation, control is returned to the worker with 
a normal completion status code in the A-register. 

If a buffer (s) is required for the operation, the 
buffer limits are compared to the PLR value that 
was in effect when the l/O request was made (PLR 
value in the S-mod) . When the buffer is found 
to lie, in whole or in part, outside the PLR setting, 
the request is aborted and control is returned to 
the worker program with an "Incorrect Parameter" 
{/i,0^0* 00002) status code in the A-register. 

At this point a branch is made if all buffers 
specified pass the above test; when the file to 
be referenced is found to be a random access file, 
the director checks the logical lock lists 
(Section 3.2.3) if applicable, and exits directly 
to the Mass Storage Handler. When the file code 
points to a unit oriented device further processing 
is required ay the director. 
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The I/O Director then, for unit oriented devices, 
calculates the size of the core module required 
by the handler to set up the I/O coiimiands. The 
size is based on the number of buffers contained 
in the request packet (list) . If a list type 
packet (see Section 3.5.2) is not involved a 
"fixed" size is used (this "fixed" size is variable 
by handler; the value is held in the UCB) . The 
size of the area to be obtained is then stored in 
the S-mod (upper of the B3 position) , 

Next a check is made to determine whether or not 
the unit is currently busy. This check is made 
using the Test and Set instruction on a location 
within the UG3. If the unit is busy the requesting 
activity is taken out of control and queued through ■ 
a location in the UCB. Requests (activities) queued 
in this manner will be executed in a FIFO sequence 
when the unit becomes available. 

If the "Test and Set" passes, a core module of the si^^e 
determined above is obtained from the free core 
chain. The address of this area is then stored in 
the S-mod (both the beginning address and size must 
be retained in order to release the area subsequent 
to completion of the request) . A direct switch to 
the handler indicated in the UCB is then executed. 

Request. 'He turn Phase 

After completion of the l/O requests, the handlers 
return control to the l/O Director. Again a distinction 
is mads between random access and unit type devices. 
Upon return from a random access handler, the director 
checks the logical lock lists, if applicable, and 
returns to the worker program. However, upon return 
from a unit type handler the director must p>erform 
certain functions before returning control to the 
worker . 

The director checks the unit queue to determine if 
any requests have been queued while the unit was 
busy. If not, the' director releases the core obtained 
for the handler and returns to the worker program. 

If any requests have been queued to. the unit the 
director examines the core requirement of the next 
request to be executed to determine whether or not 
the core area of the completed request will satisfy 
the area required by the next request. If so, the 
area is transferred to the next request; if not, the 
area is released. The next request is then removed 
from the unit queue and placed on the ready queue and 
control returned to the worker program. 
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3.2.2 Console Handler 

The Console Handler consists of two routines. One routine 
is a part of the I/O Director and functions to queue output 
messages to the console. The other routine functions to 
unpack and initiate output, and to accept and assemble input 
from the console. The two routines both access certain contvol 
locations. 

3.2.2.1 Console Queue Routine 

Purpose: 

The Console Queue Routine accepts message blocks, 
assigns Delay Numbers, if required, and queues .the 
message block to the console handling routine. Tee 
queue routine is independent of type of console. 

Entry: 

The Console Queue Routine is entered from the Console 
Control Routine (see Section 6.0 ) . Entry parameters 
include the address of the message block and the 
function code. The absolute address of the message 
block is contained in the B? position of the allocated 
. S-mod. The function code, contained in IFR lower, 
determines the type of operation. 

Exit: 

The routine exits to the Console Control Routine 
when the message has been queued or when the Delay 
has been answered. 

Operation: 

The routine first tests the function code for validity; 
if invalid, control is returned with an "incorrect 
parameter" (4.0jZl0jZi".00$2(j2l2) status in the A-register. ' 
The parameter packet is shown below: 



ENT^^B? 


VO 


EXRN 


V1 



where: Vq is the absolute address of the message 
V^ is the function code: 

'\0^0^ - queue message and return control 
1^1jZ(2 - assign delay number and queue 

message. Control is returned when 
the delay is answered. 
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CONSOLE QUEUE ROUTINE 




.ECK TABLE EOR 



NUMBER 



STORE ACTIVITY 
ADDENDUM IN 
DELAY TABLE 



RELEASE 

QUEUE 
LOCK 




RELEASE ■ 
QUEUE 
LOCK 



QUEUE 
MESSAGE 
BLOCK 



RELEASE 
t QUEUE 



SET ILLEGAL 
FUNCTION 
{STATUS 



PUSH 



PLACE ACTIVITY 
ON INACTIVE 
QUEUE 




DIRECT 
RETuRi^ 

n ^r - T \'n 

ROUTINE) 



STORE DELAY " 
NO. IN MESSAGE 
BLOCK 



QUEUE 
MESSAGE 
BLOCK 



,.,^ 



RELEASE 
QUEUE 
LOCK 




PUSH 



QUEUE ACTIVi: 
UNTIL DELAY 
ANSWERED 



r 

VEXIT7 



V 



/ DIRECT RSrjRN 
^(TO CALLING ROUTINE 
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The message block indicated in B" must have the 
following format: 



N 



i Console Queue Link 



No. of Words No. of characters 



MESSAGE 




The above message is formed by the Console Control 
Routine in response to a literal in the requesting 
program. Word is a chain cell used for linking 
the message to the console queue. The lower of 
word 1 contains the number of characters in the 
message. The upper of word ,1 contains the number 
of words in this message area (this value need not 
have any connection with the number of characters, 
it is used to release the message area to free core 
when the complete message has been unpacked) • Words 
2-N contain the output message. 

If the function code indicates "queue and return" 
the message is queued to the console output queue 
and control is returned to the Console Control Routine 
at the location following the packet. 

If the function code indicates that a delay number 
should be assigned, the routine chooses an unused 
number from the Delay Table shown on the following page 
and places this number in bits 2^^ - 7r^ of word 1 
of the message block. The activity addendum address 
is placed in the Delay Table, and the message block is 
then queued to the console output queue. The activity 
is then placed on an inactive queue until this delay 
is answered. 

The Delay Table is used to associate a delay number 
with a particular activity and to indicate those 
numbers currently in use. 
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TW.r.hy TAPiT.i? 



Delay No, 



01 
02 
03 



N 



' ACTIVITY 


ADDENDUM 


^ 


1 ACTIVITY 


ADDENDUM 


^■■^ 


\ 



The Delay No. is implied by .position in the table. When 
the number is in use the associated activity addendum 
address appears in the corresponding table position. When 
the number is unassigned its table location is zero. 



3. 2 #2. 2 Console Handling Routine 
Pumose 

- - — j: ^ 

The Console Handling Routine is the interface between- 
the Console Control Routine and the hardware. The 
routine unpacks and initiates output to the console, 
and accepts and packs input from the console. 

Entry and Exit 

Entry to the routine is from va'rious points within 
OMEGA when output is inactive on the console channel. 
Exit is made to the point of entry. 

Output Operation 

Upon receiving control the routine examines the 
console output queue. If the queue is empty the 
routine exits. If the queue is not empty the 
following operations are performed: 

•The first request (FIFO) is removed from the queue. 

•The message is unpacked and placed in the routine ' s 
output buffer. 

•If a delay number is indicated the number is added 
to the output buffer in the form "DXX". 
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•The output buffer control word is set up and 
output initiated on the console channel. 

•A "control thread" is established so that the 
message area may be released to the free core 
chain . 

'Control is returned to the Console Control Routine, 
or, if a delay number is assigned, the activity 
is queued through the PUSH$ operator. 

Input Operation 

When output is not active the handler will accept 
input from the console. Answers to messages with 
delay numbers are restricted to ten characters 
exclusive of the delay number. The first ten characters 
entered will be returned in the AQ-register (the 
delay answer is intended primarily for positive/ 
negative type response) . All other entries will be 
assembled in free core and passed to the Console 
Control Routine for interpretation. The routine 
ultimately receiving the message is responsible for 
releasing the message area to the free core chain. ' 
The input message will have the following format 
when given to the Console Control Routine*. 



No. of Words No. of Data Char. 



INPUT DATA 



The "No. of Words" is the length of the message area 
to be released to the core chain. 

Cetain conventions and control characters have been 
established for console input. These are delineated 
below: 

•An input message must be initiated by a "carriage 
return" (Fieldata code 04-) . Any character entered 
before the carriage return will be ignored. The 
carriage return will cause two line feeds and a 
carriage return to be sent to the console. 

•Each character will be sent to the console printer 
as it is entered. If an input character does not 
appear on the console printer, it has not been 
recognized by the handler. 
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'The maxinmin number of characters per input 
message is 32 decimal. 

•The Fieldata code 77 (/^ ) is used as an erase 
code. Entering this code will cause the last 
Character entered to be deleted fjrom the message. 
Two erase codes in succession will cause the 
last two characters to be deleted. Three erase 
codes in succession will cause the entire message 
to bs deleted s 

•The Fieldata code 57 ((s)) is used as a stop codej 
it signifies the end of an input message. 

•The carriage return (04-) , line feed (03) , erase 
code (77), and master space (OO) if entered, will 
not be placed in the message buffer and will not 
count against the maximum message size. All 
other characters entered will become part of the 
input message. 

•Characters placed in the input message will be 
left justified as they are entered. Unused 
character positions of the last word (following 
the "stop code") will be cleared to master spaces 

•The "initiate input" character (carriage return) 
may be entered during a console output operation. 
It will be recognized as soon as the output 
operation has been completed. 
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3.2.3 Logical Lock of Mass Storage 

Logical Lock is an element which may be collected as part 
of the l/O Director. Logical Lock pertains only to mass 
storage files. If a lock function is received for a unit 
device, the operation will be performed as if given without 
lock. When Logical Lock is included in the director, mass 
storage may be accessed both with and without lock functions. 

Read, write, and search requests may be given both with and 
without lock. Functions without lock are provided so that 
tiffi© ia not spent searohl^g th# lists when the lock condition 
is unimportant. The following interpretations are placed on 
the functions: 

•Read - The lock list is not checked. The read is performed 
regardless of whether or not the area is locked. The 
area read is not placed on the lock list. 

•Read Lock - The lock list is checked. If any part of the 
area to be read is locked the request is delayed until the 
area has been released. When the area is not locked- the 
read is executed and the area is placed on the lock list, 

•Write - The list is not checked. The write is executed 
and no release is made. If the area is locked it remains 



•Write Release - The lock list is checked. If any part of 
the area being written is within a locked area, that complete' 
entry (or linked entries) is removed from the list. When 
an area is to be released without actually writing into it, 
a Write Release may be given with the address within the 
locked area and the number of words equal to zeroe 

•Search - The list is not checked. If a find is made the 
area is read regardless of lock condition. 

•Search Lock - The list is checked when and if a find is 
made. If the area is locked the request is delayed until 
the area has been released. When unlocked, a read is performed 
at the find address and the area read is placed on the lock 
list. If a find is not made the area is not entered on the 
list. 



Operation 

When the l/O Director detects a request for a mass storage file, 
the function code is tested to determine if it is a lock 
function. A "read lock" function will cause the I/O Director 
to search the lock list. If any part of the area to be read 
falls within an' area contained on the list, the activity is 
queued until the area has been released. When the area to be 
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read is not found on the lock list the area is then placed on 
the list and control given to the mass storage handler for 
execution. The area will be locked regardless of the results 
of the read operation, 

A "write release" function is given by the I/O Director directly 
to the mass storage handler. When the director receives 
control from the handler at completion of the write, the lock 
list is interrogated. If any part of the area written lies 
within a locked area, that area is removed from the list. At ' 
this time the queue of activities inactive because of a "read 
lock" request is checked to determine if any of these requests 
may now be executed. If so, the activity is removed from the 
inactive queue and placed on the ready queue. 



Lock Lists 

A lock list is maintained for each mass storage subsystem. The 
lists consist of four word entries chained together. Normally 
there will be one entry per locked area. If, however, the area 
to be read covers two or more noncontinguous areas of the file., 
multiple entries must be made. The four word entry is shown 
below. 



Word 








17 

QUEUE LINK 


1 


BEG. ADDRESS OF LOCKED AREA • 


2 


15 

LINK 


NO. OF WORDS 


3 


15 

JOB NO. 


ACTIVITY I.D. 


(B6) 



Word - Chain cell linking all entries on the lock list. 

Word 1 - Beginning address of lacked area. The address is 
a subsystem logical address (physical address of 
drum subsystems) . The lists are maintained in 
order of ascending address. 

Word 2 - "No. of words" is the size of the locked area for 
this entry. 

"Link" is a number assigned to identify all multiple 
entries which are the result of locking non-contiguous 
file areas. If the link is zero this is not a 
imiltiple entry. 
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Word 3 - "JOB No." of activity locking this area. Used 
to delete entries which may be present when the 
task terminates or is aborted. 

Activity I.D. is the identity of the activity 
locking this area. Activity I.D. is contained 
in B6 when the request is made. This identity 
is used to delete any entries which may be on 
the list when the activity • terminates ♦ 
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•3.3 Device Handlers 

3.3*0 General Description 



Device Handlers are divided into two broad catagories — Unit 
Device Handlers and Mass Storage Device Handlers. The main 
distinction between the two types is the hardware address 
calculation required in the Mass Storage Handlers, Magnetic 
tape, card, printer, and 1004 handlers oomprise the Unit 
Device Handlers, ?h=432, FH-SSO Drums, and FASTRAMD I are 
classified as the, Mass Storage Handlers, All Device Handlers 
are interruptable and re-entrant. Each handler has an 
Initiation Phase, and an Interrupt Phase. 

Initiation Phase 

The Device Handlers are entered in the Initiation Phase from 
the I/O Director. The addresses of the Storage Module and 
The Unit Control Block are contained in 64 and B5 respectively. 
When a parameter error is detected, the Initiation Phase 
exits to the I/O Director with the appropriate status code in • 
the A-registei*. If any l/O instructions are to be executed 
in response to the packet, this phase exits to the Hardware 
Function Executor. 

Interrupt Phase 

After the Hardware Function Executor has initiated the functions 
or series of functions and all interrupts have occured for a 
particular l/O Module, control is returned, at the activity 
priority, to the interrupt phase of the Device Handler. The 
hardware status code and the buffer control registers 
are stored, for external interrupts, by the Hardware Function 
Executor. Exit is made to the l/O Director to list the activity 
on the ready queue or to the Executive to call a recovery routine 
from the system mass storage. 

Unit Device Handlers 

In the Initiation Phase, the Unit Device Handlers will check 
the function code and buffer control, word to determine if they 
are appropriate to the particular device. If the parameters 
are found to be correct, the Device Handler then proceeds to 
set up the l/O Module with the information required by the 
Hardware Function Executor (the format of the l/O Module is 
described in Section 2.2.3 ). After setting up the l/O Module, 
the handler scans the channel initiation queue to determine the 
most advantageous position for the request. Exit is made to 
the Hardware Function Executor with an indication of where the 
module should be queued. 
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Upon regaining control in the Interrupt Phase ^ the Unit 
Device Handlers examine the hardware status word(s) placed 
in the l/O Module. If the operation has been successfully 
completed, the status code is placed in the A-register, any- 
supplementary information is placed in the Q-register, and 
exit is made to the l/O Director. 

Functions that could not be performed (Servo rewinding, etc.) 
are reinitiated by setting up the l/O Module and again placing 
the module with the Hardware Fimction Executor. If error 
recovery is necessary, the appropriate recovery routine is 
called from mass storage by the Device Handler and operated 
as described in section 3.4.1. 

Mass Storage Handlers 

In addition to the above procedures the mass storage handlers 
must calculate the physical address of the request from the 
logical file address contained in the packet. The logical 
file area referenced may cover non-continguous areas of mass 
storage unit(s); in this case the handler must generate a 
separate function and buffer for each physical area. 
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3.3.1 Magnetic Taps Handler 



Purpose; 



Entrance: 



Exit: 



To Formatter: 
To I/O Director: 



To' transform a magnetic tape l/O request into the 
designated, tape; operation, analyze the external 
interrupt (s) which occur from this operation and 
notify the l/O Director of the results. 

Entrance to the Magnetic Tape Handler is made 
through the l/O Director, Parameters are conveyed 
through B registers and the Storage Module set up 
at l/O request time. Parameters upon entry are: 

B4 - Address of the Storage Module set up at 
. l/O request time. , 

B5 - Address of the Unit Control Block of the 

magnetic tape unit marked for an l/O operation. 

Word l6g of the Stora:ge Module - Address of free 
core to be used by the Magnetic Tape Handler 
when setting up command words for executing 
the designated l/O, 

Exits are made by the Magnetic Tape Handler to the 
Formatter for execution of the designated l/O, and 
the I/O Director to report the results of the 
executed l/O. 

Parameters are conveyed in the A, Q and B7 registers 
as specif ied -by the Formatter, 

Parameters are placed in the Storage Module 
Dositions as follows: 



B7 - Contains the octal number of the last data block 

correctly passed over, backward or forward,. by the. 
' Magnetic Tape Handler if numbered data blocks have, 
been requested by the user. 

A - The code designating the status of the l/O operation 
performed. See chart and notes on pages 6 and 7. 

Q - The number of words correctly, read or written in 
the I/O operation. See charts and notes on pages 
6 and 7. 



3.3.1^1 






All magnetic tape l/O requests will be serviced by one Magnetic 
Tape Handler. Functions applicable to magnetic tape will be 
serviced identically on all subsystems with the exception of 
READS on Uniservo 3C/4.G, which is serviced as a backspace block. 

If designated through the ASSIGN statement, an octal number will 
be placed on each data block written numbering sequentially with 
load point designated as zero. The number of the last data block 
successfully passed over during the I/O operation is returned to 
the user in the B7 register. An out of sequence status appears 
in the A register as ^0011*00|2(XX (XX = l/O status) . .The current . 
block count for each unit is maintained by the Magnetic' Tape 
Handler in the appropriate Unit Control- Block. 

After executing an l/O packet, the Magnetic Tape Hiandler notifies 
the l/O Director of the success or failure of the operation. No 
repositioning or error recovery is attempted by the Magnetic Tape 
Handler, but is accomplished by a separate Error Recovery Routine 
(see Section 3.4.»1). 



3.3.1 .2. Operational Mode 



All Information influencing the way magnetic tapes .are to be 
written or read is stored or maintained in the Unit Control Block ' 
for that particular unit. This information is put there through, 
the use of the ASSIGN statement and maintained by the Magnetic 
Tape Handler when necessary. Two words, KUCB1 and KUCB2, words ' 
7g and IJZfg respectively are used to hold this information'. 

KUCB1 

A bit is set in this word to designate numbered data blocks 
to be written, the "Noise Constant" to be used on this 
particular unit when applicable is stored here and the 
initialization constant specifying density, parity, etc., 
to use when writing and reading on this particular unit, is 
contained in this word. 

'. Numbered Data Blocks 

Bit 2^^=^ of KUCB1 designates each data block to be 
written with an octal number making up the first word of 
the block. These data blocks will be numbered sequen- 
tially with load point designated as zero. 

This number is written with a GWRITE operation and read 
with an SREAD operation from the Magnetic Tape Handler, 
hence, the number will not be reflected in the data 
used. The number of the last block correctly passed 
over, reading or writing, backward or forward, is 
retui'aed to the user in the B7 register. An out-of- 
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ssqusnes status is indicated with an 11 in A register 
upper. REWIND or REWINDI result in the B7 register 
being returned as zero. 

Noise Constant 

Bits 2^ - 2^ are used to hold the "Noise Constant" 
for a specific unit when applicable (Uniservo 3C, 4C, 
6G, 80). All blocks read or moved over causing an 
error status, the length of which is less than or equal 
to the "Noise Constant" will be considered as foreign 
material on tape and disregarded. 

Initialization Constant 

This constant specifies the density, parity, etc., 
which should be used when reading or writing tapes on 
this particular unit. This constant is only applicable 
to Uniservo 3C, AC, 6C, 8C subsystems. Values of this 
constant are listed below. 

If numbered data blocks and a "Noise Constant" are 
specified, they will be included within the constant. 






Binary Coded Decimal 200 ppi 03200^50000 

Binary Coded Decimal Translate 200 ppi . 032\0^5k000 

Binary 556 ppi , '02000^20000 

Binary Coded Decimal 556 ppi 02200^60000 

Binary Coded Decimal Translate 556 ppi 022'\0^6k000 

Binary 800 ppi 02020*30000 

Binary Coded Decimal 800 ppi 02220^*70000 

Binary Coded Decimal Translate 800 ppi 02230*74000 

Binary 800 ppi 9 Channel (Uniservo 6C, 8C only) 00000^32000 

KUCB2 

The upper half of this word is used to maintain the octal, 
number of the block of tape just passed over on this 
particular unit when numbered data blocks are designated. 
This number is maintained by the Magnetic Tape Handler. 



3.3.1-3 



3 . 3 • 1 . 3 • Function Sxe oution 

Applicable Functions 



The resulting operation of l/O packets marked for execution 
by the Magnetic Tape Handler is described below, 

READ - One block of data, not to exceed the word count, 
will be read in the forward direction into the 
area designated by the buffer base, A word count 
of zero will result in a move forward, without 
data transfer, of one block, 

WRITE - One block of data, designated by the word count 
and buffer base will be written on tape. A word 
count of zero will result in the return. of an 
illegal parameter status,- 

READS - One block of data, not to exceed the word count, 
will be read in the backward direction into the 
area designated by the buffer base, A word count 
of zero will result in a move backward, without 
data transfer, of one block, 

WRTEOF - The appropriate hardware end -of -file mark will be 
recorded on tape, 

REWIND - Tape will be positioned at load point, 

REWINDI - Tape will be positioned at load point with the 
designated unit in an interlock condition, 

ERASE - A fixed area of tape will be erased. 



SREAD 



GWRITE 



MREAD 



One block of data will be scatter-read into the 
areas dictated by the word counts and buffer 
bases designated in the LIST packet. Word counts 
of zero will be ignored. 

One block of data will be gather-written into the 
areas dictated by the word counts and buffer bases 
designated in the. LIST packet. Word counts of 
zero will be ignored. 

Sequential blocks of data, dictated by the word 
counts and buffer bases of the LIST packet, will 
be. read or passed over. Word counts of zero will 
result in blocks of data being moved over without 
data transfer. 



3.3.1-4 



Method of Execution 

Upon entry, the Magnetic Tape Handler retrieves the function 
code and l/O packet address placed in the Storage Module, 
Through examination of the l/O packet the function code, it 
can be determined how many command words, buffer control 
words, and buffers are needed to execute' the designated l/O, 
These parameters are then formed in the free core assigned, the 
address of whioh is oontainsd in word l6g of the Storage Module. 

After setting up the free core with parameters for l/O execution, 
an examination is then made of the Unit Control Block to determine 
which function is needed for the l/O operation. This function is 
dictated by the type of subsystem the unit is on. After this function 
is formed, it is placed in the free core and an Exec Return is made 
transferring control to the Formatter for l/O execution. 

Upon re-entry,, the l/O has been executed and external interrupt (s) , 
have been stored. After examination of these interrupt (s) , the 
Magnetic Tape Handler determines whether the I/O has been successfully 
completed. If so, the appropriate status is placed in the A register 
position, the. number of words transferred,, if any, in the Q resgister 
position and the number of the last data block passed over in the B? 
position, if applicable, of the Storage Module. If errors have 
occurred during l/O execution, the. Magnetic Tape Error Recovery 
routine is called for comprletion of the l/O - Controi is then 
returned to the I/O Director through an Exec Return. . 
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(See notes for AX, 
QY explanation)- 



STATUS 




§ 



o 
o 



Pn 



p:; 



Eh 
O 



O 
O 

M 



o 



w 



PQ 



.o 



* 



W 

M 

I 

O 
I 



,w 



Eh 
I 

I 



w 



READ 



AMI 



A1,Q1 



A2,Q2 



A3, 1 



A4.,< 



WRITE 



A0,Q1 



A2,Q2 



A37Q0 



A5,Q1 



READB 



A^,Q1 



A1,Q1 



A2,Q2 



A3, 00 



A4,( 



A0,Q0 



A$,Q1 



WRTEOF 



A2,Q2 



A3, 00 



At>.Q0 



1 



REWIM) 



A0,Q0 



A2,Q2 



A3, 00 



A0,Q0 



REWINDI 



A0,Q0 



A2,Q2 



i-^i 



ERASE 



JxK, ,'qi'- 



A3,< 



A5,Q0 



SREAD 



A0,O1 



A1,Q1 A2,Q2 



A3, 00 A4,( 



GWRITE 



A0,O1 



A2,Q2 



A3, OP 



— wr- 
A1,Q1 



^?4^»4V. 



A5,Q1 



MREAD 



A0,O1 



A2,Q2 



A3,Q1 Ai!„Q1 



A Register value of the Storage Module 

A1 » 00000^00001 

X = Magnitude of Frame Count 

A2 - 40000*00002- 

A3 - 4.0000*00003 

A4 - 00000*00004 

A5 - 00000*00005 

Q Register value of the Storage Module 

00 - 00000*00000 

Q1 - 



XXXXX = number of words transferred 
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Q2 - yiYYY^IYYYY 

Y... = meaningless information 



* Tape is positioned beyond the block in error 

**' The last block of the series read having an abnoraml Frame Coiint 
will be indicated. 

*** Tape will be positioned beyond the last block indicated to be 
read. 

The number of words successfully read of the blocks indicated will 
be contained in the Q Register. 

^nit^ Tape will be positioned beyond the End-of-File marker. The number 
of words read before the End-of-^ile marker was encountered will 
be indicated in the Q Register. • 
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B4 = SHOD Address 
B5 = UCB Address 



GET FUNCTION 
CODE FROM 
SMOD 




GET PACKET 
ADDRESS FROM 
SMOD 




COMPUTE jf OF 
COI^JIND WORDS, 
BCW'S, BUFFERS 
NEEDED 





SET UP BUFFER 
CONTROL WORD 




FORM 

APPROPRIATE 

FUNCTION 



GET. PROGRAM 
PRIORITY 
NUMBER • 



QUEUE 
PLACEMENT. ACCORD-] 
ING.TO PRIORITY 
NUMBER 



(^_J 



TO FORMATTER 




FROM FUNCTION 
EXECUTOR 



EXMINE 
INTERRUPT 
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YES 




APPROPRIATE 
STATUS TO 
SMOD 



SET INTERLOCK 
FLAG IN 
SMOD 




NO 




YES 



NUMBER OF. • 
WORDS 
TRANSFERRED TO 
SMOD 




UPDATE BLOCK 
COUNTER IN 
UCB 



APPROPRIATE 
BLOCK NUMBER 
TO StiOB 



C 




SET ERROR 
RECOVERY FLAG 
. IN SMOD 



(£) 




ILLEGAL 

STATUS 

TO SMOD 



© 



EXIT 



) TO I/O 
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DIBROTOR 



3.3.2 High Speed Printer Handler 

PURPOSES To verify the packet information and use it to form 
High Speed Printer Command words. After the Commands 
have been executed the Handler will analyze the 
interrupts and notify the l/O Director and/or the 
User of these results. 

ENTRANCE* B4 = Address of Storage Module 

B5 - Address of Unit Control Block 
B7 of SMOD = Address of Packet 
SMOD+17 = Address of Core Module 

EXIT TO FORMATTER: As specified by the FORMATTER 

EXIT TO I/O DIRECTOR! 

A register of SMOD = 0000000000 - Successful Completion 
, " " " " = 4000000001 - Inappropriate Function 
' " " " " = 4000000003 - Unrecognizable Interrupt Status.. 

The Unrecognized Interrupt Status 
will.be in the Q register of SMOD. 



This handler will control printing and spacing coiranands on both 
the 0751 printer and the new 11 00-1 600 line per minute printer. 

Form control is achieved by specifying the top and bottom 
margins and the number of printable -.lines per page (the sum 
of these three quantities must be equal to the physical page 
length) . This specification is made in the ASSIGN statement 
and the values are placed in the Unit Control Block of the 
printer. Printing will not occur within the margins — whenever 
the handler senses that, with the spacing given in the packet, 
the print line will fall within either the top or bottom 
margin, the paper is spaced to the next printable line and the 
print executed there. Spacing within the printable area, 
however, is the responsibility of the activity. The physical 
line position of the printer is maintained by the handler in 
■the Unit Control Block, This line counter is cleared whenever 
a new printer ASSIGN statement is processed. At this time, it 
is assumed that the paper is positioned at the first physical 
line (at the fold) . At the completion of each print job a 
"Home Paper" command should be given in order to position the 
paper at the first physical line in anticipation of a new 
ASSIGN statement. 

The WRITE function is the only function recognized by the 
printer handler; all others will be returned as inappropriate. 
The "Number of Words" in the printer packet is used as the 
number of lines to be spaced — the handler wil". output a 
twenty-seven word buffer (one print line) begin ring with the 
buffer base specified in the packet. One 132 c.'Aracter line 
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will be printed for each request (the line may be less than 
132 characters if the "77" stop code is detected within the 
buffer) . The number of lines to space before printing is 
contained in the packet. If the number of lines to space is 
equal to zero, printing will occur on the same line as that 
of the previous request. When the "number of words" in the 
printer packet is found to be 4^000q (2'^ set) a skip to the 
first physical line of the next page will be performed, 
"Home Paper" - no printing will occur, A print request 
received when the paper is positioned at the first physical 
line will be performed at the first logical line (the physical 
line minus the top margin) and packet spacing will be ignored. 

The handler will place each request received at the end of 
the channel queue. 

No form control may be specified by listing the number of 
printable lines with the value of zero in the ASSIGN statement. 
If this is done, all subsequent spacing and printing will be 
performed as directed by the WRITE orders. The top and 
bottom margins will then be the responsibility of the user. 

When the "Out of Paper" indication is detected, the handler 
if under form control will allow printing to the bottom of 
the page, then an interlock condition indication will be 
returned. The new forms should be physically positioned at 
the "Home Paper" position (first physical line) . Thus when , 
control is returned after the interlock (out of paper) has 
been satisfied, the paper will be spaced to the first printable 
line and the line will be printed. 

If "Out of Paper" occurs and form control had not been specified, 
the printing will continue until it is possible that a line 
had been printed below the paper. An interlock condition will 
then be indicated. The new forms should be mounted with the 
fold in the same physical position as the previous. Answering 
the interlock will cause the same line to be reprinted on the 
new form without spacing since the spacing was performed 
earlier. 
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UNIT GONTSOL ELOGK 



p ■ 


HANDLER RIR 




A : ■■^', 


UCR T.TM 


■ 


"2": 


P-TIPE CH/CH/ONIT 




'3 ■'■• .■ 




LINK TO CCB 




■^ ■".';,' 


LENGTH OF UCB 


# OF REG. 


KUCBNO 


5 :■;■ 


MIN CM. SIZE 


TEST & SET LOG 


KUCBOI 


^6'';v 




UNIT TNACTTYF, OKr.T. 


KUGB^- 


7-;-.'- ■■• 


UPPER MAR. 


LOWER MAR. 


KUGB1 


10 


LINE POS. 


PRINTABLE 
LINES/PAGE 


KaCB2 


iv 




OUT OF PAPER 


KUGB3 



The processing of the ASSIGN statement will place the upper 
margin, lower margin and the number of printable lines per 
page in the proper positions of the Unit Control Block. The 
Line Foaition and Out of Paper locations will be cleared to 

■■2e3?o«ei;y:''vr'v; .. ■ 
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\ ENT/ 




^^PROPRIATE 
FUNCTION 




CALCULATE 
ACTUAL 
# LINES TO 
SPACE 



SET UP 
COMMAND 
WORDS IN 
CORE MOD. 



SET UP 
REST OF 
CORE MOD. 



FROM 
FORMATTER 




TO 
FORMATTER 



SUCCESSFUL 
COMPLETION 



OUT OF 
PAPER 
INTERRUPT 




ITF 



INTERLOCK 



S 



PNRECOGNIZED 

INTERRUPT 

STATUS TO 

Q OF S-MOD 




ACTUAL 
OUT OF 
PAPER 
(00Pf17LINE^' 

N 



SUCCESSFUL 

STATUS 

TO A OF 

S-MOD 



i;;^ 



TO 
I/O 



\~^ DIRECTOR 



INTERLOCK 
STATUS TO 
A OF 
S-MOD 



STATUS 
TO A OF 
S-MOD 
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CORE MODULE 



For. Handler Use 



; r Interrupt Status Store Address 

2 Terminate Coimnand 

3 XF Conmiand 
4, Buffer Command 

5 XF Command 

6 Buffer Command 

7 Fastfeed Buffer Control Word 

10 XF Control Word 

11 Buffer Control Word 

12 Store for Interrupt Status 

13 Store for Input Buffer 

14 Store for Output Buffer 

15 Store for Interrupt Status 

16 Store for Input Buffer 

17 Store for Output Buffer 
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HSP. CHARACTER CODES 
{63-character set) 

Detail Sequfence 



40 ) 

4.1. - 

42 • + 

43 < 
44- = 

45 > 

46 & 

47 $• 

50 ^t: 

51 . ( 

52 ^ 

53 : 

54 ? 

55 I 

56 , 

57 \ 

60 

61 1 

62 2 

63 3 

64 4 

65 5 

66 6 

67 7 

70 8 

71 9 

72 ' 

73 ; 

74 / 

75 . 

76 W 

77 i 



When selection is made for the 62-character set, code 77 becomes 
a stop code; as such it is non-printable. 



Note: In order to accomplish the proper spacing capabilities 
provided by the printer subroutine, the 62-character 
set must be selected. Selection is controlled by a 
manually operated switch located on the printer control 
unit. 
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3.3.3 Card Reader Handler 



PURPOSE: To verify the packet information and use it to foim Card Eead 

command vfords. After the Commands have been executed the Handler 
■will analyze the interrupts and notify the I/O Director and/or 
the User of these resiilts. 



ENTRANCE: BU = Address of Storage Module 

B5 = Address of Unit Control Block 
B7 of S-MOD = Address of Packet 
S-M)I>ir17 = Address of Core Module 



EUT TO FOEKATTER: . As specified by the FORMATTER 
EHT TO I/O DIRECTOR: 
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register of S-MDD 
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If 
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It 


zz 


II 


It 


It 


It 


. = 


ti 


it 
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0000000000 - Successful Completion 

4.000000001- Inappropriate Function 

A000000002- Buffer too small 

4,000000003- Unrecognizable Interrupt Status. The 

Unrecognized Interrupt Status will be in 

the Q register of S-MOD. ' 



The card reader handler will recognize the READ and MREAD (function 
codes 01 and 26) functions; all others are inappropriate. 

The READ function will transfer the data from one card to the computer* 

The MREAD function will transfer multiple card images into the core 
buffers as specified by the LIST operator. Each buffer, must be large 
enough to contain the data tvom. one card. 

The mode of a card file is specified by the ASSIGN statement. There are 
two possible modes: TRANSLATE and BINARI. When the assign statement 
is processed, the appropriate mode will be set and the card memory will 
be cleared. Thus if the card read mode is changed in the middle of a 
deck, three blank cards should be inserted at this point to prevent the 
loss of card data. 

The TRANSLATE mode will cause each subsequent card that is fed to be 
translated from Hollerith code to a six-bit "internal" code. This 
"internal" code is defined by a conversion matrix within the card reader. 
Normally, Fieldata code is used. In this mode, one card occupies 16 
computer words. The buffer specified by the read packet must be greater 
than or equal to 16 words, less than 16 words is an illegal parameter. 
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The BIHAHI mode "will cause each subsequent card that is fed to bs read 
in the coltrnm binary mode. Two and one-half card columns represent 
one 30-bit computer vord. A minimum buffer of 32 vords are required, 
less than this is an illegal parameter. . 



UNIT CONTEDL BLOCK 
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UCB LINK 
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CH/CH/UNIT 




LINK TO COB 


LMGTH OF UCB # OF ESQ 


MIN CJl. SIZE TEST & SET LOG. 


■ 


■■UNIT 
INACTIVE 0. CKT.T, 


GAED MODE 
0^0 QR OAO , 



KUCBNO 

KUCBCM 
KUGBQ 
HJCB1 



The processing of the ASSIGN statement will place the mode indicator 
(020 or 040) in ¥ord 7 of the UGB. The card memozy will also be cleared 
at this time. 
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CORE MODULE 



mm 
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FOR HANDLER USE 

Interrupt Status Sotre Adr. 

BUF G>fl) WD 

XF CMD WD 

XF 

BUFFER CONTROL WD ' 

Interrupt Status ,Storo 

Buffer Status Store 



H READ 



7 

10 

11 

12 

13 

14 

• -«' 

16 

17 

20 

21 

22 

23 
2/ 

25 



FOR HANDLER USE ' . 

Interrupt Status Store Adr. 

1st BUF UMD WD 

1st XF CMD WD 

■2nd BUF MOD WD 

2nd XF CMD WD 

3rd BUF CMD WD ' 

3rd XF CMD WD 

XF 

1st BUF CW 

2nd BUF CW 

3rd BUF CW 

.1st Int. Status Store 

1st BUFIN Status Store- 

1st BUFOUT Status Store ' 

2nd. INT Status Store 

2nd BUFIN Status Store 

2nd BUFOUT Status Store 

3rd INT STATUS STORE , 

3rd BUFIN STATUS "STORE 

3rd BUFOUT STATUS STORE , 



X - Number, Locations Required 
for Core Module 

Y «- Number Wds in Packet 



X =. 3X + 4 
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3»3»4 Card Punch Handler 



PUEPOSE: To verify the packet information and use it to foim Card Punch 
Coinmand words. After the Commands ahve been executed the Handler 
will analyze the interrupts and notif^r the l/O Director and/or the 
User of these results. 

ENTRANCE; B4 = Address of Storage Module 

B5 = Address of Unit Control Block 
B7 of S-MOD = Address of Packet 
S-MOD + 17 = Address of Core Module 

EXIT TO FORMATTER: As specified by the FORMATTER 

EXIT TO I/O DIRECTOR: 

Successful Completion 

Inappropriate Function 

Buffer too small 

Unrecognizable Interrupt Status .'The 

Unrecognizable Interrupt Status, will 

be in the Q register of S-MOD. 
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The card punch handler will recognize the WRITE' function (01 ): all others 
are inappropriate. The \WRITE function will transfer data from the 
computer to the card punch unit and cause it to be punched into a card.. 

The mode of a card file is specified by the ASSIGN statement. There 
are two possible modes: TRANSLATE and BINARI. The desired mode will 
be set as the ASSIGN statement is processed. 

The TRANSLATE mode will cause each subsequent card that is punched 
to be in the Hollerith code. In this mode, one card occupies 16 
computer words. The buffer specified by the write packet must be 
greater than or equal to I6 words: less than 16 words is an illegal 
parameter. 

The BINARI mode will cause each subsequent card that is punched to be 
punched in the column binary mode. Two and one-half card columns 
represent one 30-bit computer word. A minimum buffer of 32 words are 
required; less than this is an illegal parameter. 
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UNIT CONTROL BLOCK 
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UGB LINK 
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LINK TO GCB 


LENGTH OF UCB 
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TEST & SET LOC 




UNIT 
INACTIVE Q CELL ' 




CARD MODE 
020 OR OAO 
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KUGBQ' 
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Tae proeessing of the ASSIGN statement will place the mode 
indicator (020 or Oi^O) in word 7 of the UCB. 
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HANDLER USE 



INTERRUPT STATUS STORE ADDRESS 



XF COMMAND WD 



BUFFER COMMAND WD 



BUFFER C.W. WORD 



XF CONTROL WD 



INTERRUPT STATUS STR 



BUF. IN STAT STR 



BUF. OUT STAT STR 
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3.3.5 Omega Mass Storage Handler 

PURPOSE: To interface the mass storage subsystem(s) with the Omega 
executive and programs running in its environment. 

ENTRANCE: EXEC Return 77540 100FC 

B4 = Address of Storage Module 

B5 = Address of Random Access Storage List 

B7. = Address of Packet 

FC fn READ 

Transfer to core the data found on mass storage ad. defined 
by the manipulation of the Logical Address given in the 
Random Access Storage List (RASL), the Logical Increment (Ll) 
as given in the packet, and the logical to hardware address 
conversion parameters given in the Unit Control Block (UC-B). 
The number of words to be read is given in the lower 15 bits 
of the packet, and is limited by the length of file (RASL) 
and the LI, The buffer base is defined by the sum of lower 
PLR register and the second packet word. 

Upon return of control report the status of the function in 
the A register (A) and the number of words read in the 
Q register (Q). 

FC pi WRITE 

Transfer data from core to mass storage. (See FC J^l) 

FC JZ53 BLOGKR 

(See FC p\) If an End-of-Block (EOB) external interrupt 
(EI = j^4.) is received report the contents of the lower 24- bits 
of the Overflow Word** in the upper 24 bits of the A register at 
return of control. The number of words read is reported in Q, 



*This paper is specifically generated for the 5H880 drum handler. When 
the details of the Fastrand - 513880 handler are defined, this paper will 
be corrected to show changes of philosophy as related to both subsystems. 

'^^kn Overflow word is the contents of a drum storage location following an 
End-of-Block sentinel (a location containing the octal word 7777777777). 
Bits 2^ through 224 of the" Overflow Word Siisi t>e zeros. The contents of 
the Overflow Word is logically added :to?'04000 00000 and reported as an 
external interrupt . 
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FG ik BLOCKS 



Search for the FH880 address containing the data word 
given in the fourth word of the packet. Transfer no data. 
Report the address of this mass storage locztion in terms 
of a logical increment to the first address of the file 
(Q). If an EOB sentinel is detected before a find is made, 
report an Unsuccessful Search status (06) , and the contents 
of the Overflow word in A. 



FC 24 SREAD 



(See FC 01) Transfer consecutive data locations from a 
single mass storage file to one or more core areas. 



FC 25 GWRITE 



(See FC 02) Transfer data from one or more core areas to 
one continuous area of mass storage file. 

FC 26 MRMD 

(See FC 01) Transfer one or more data areas of a single 
mass storage file to one or more core areas. 

Exit 

The status codes reported upon exit are: 

0000000000 - Normal completion 

XXXXXXXXXO - This is the normal completion response to the 
BLOCKR function. The upper 24- bits of A 
contain the lower 24 bits of the Overflow Word. 

4000000001 - Inappropriate function - the function code is 

not applicable to the subsystem. (SEARCHT 
issued to an FH880 subsystem, etc.) 

4000000002 - Incorrect parameter - This status indicates 

that thedata transfer is outside of the program 
lock limits. Under this condition this status ■ 
code is generated by the l/O Director. 

This status code is generated by the handler if: 

•The Logical Increment specified in the packet 
is negative. 

•An MREAD packet does not contain a Logical 
Increment (Bit 2^9 ©f the first word of the 
LIST =1) 
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•The peripheral tvDe code as given in the 
UBC 4. 

•A negative hardware address is generated. 
This condition will occur, if the LA as given 
in the RASL is less then the fijcst LA of the 
unit. 

•The packet and file or so constructed as to 
cause the generation of 33 or more consecutive 
buffer control words. 

4000000003 - Unrecoverable Error - This code indicates that 

the function could not be completed without 
error interrupt. The handler will issue the 
function a total of four times before returning 
this status. 

4000000004 - End-of-File - This code indicates that the 

function requested a transfer of data from 
(or to) an area of mass storage outside of the 
file. Reading or writing -in the last address 
of a file will not cause the generation of an 
04 status , An 04 response to a write function 
indicates that no data was transfered. 

3PCXXXXXX06 - Unsuccessful Search - At the handler level, this 
response can only be received in response to a 
BLOCKS function. It indicates that an EOB 
interrupt was received before a find was made. 
The lower 24 bits of the Overflow Word are 
contained in A. 
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The following table illustrates all legal functions at the handler 
level, and the possible responses to' these functions. The presence 
of a number at the intersection of a function code and status code 
indicate that the particular status may be received for the prescribed 
function. The number at the intersection is applicable to the notes 
which follow. The conditions which caused .the generation of a particular 
status have been defined* 
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25 GWRITE 
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Key to Q register values 

1 . Q = the number of data words written or read. 

2. Q = unknown 

3. See #1 above. No data will be transferred, and Q = 0. 

4. See #1 above. An end of block sentinel was not read. 

3* Q = the logical increment as related to the base address of 
the file. 
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The handler will allow a program to reference from 1 to 32768 words 
of mass storage whether the subsystem be an FH880 or Fastrand. 
Packets which contain more than one set of parameters (SREAD, GWRITE, 
$MREAD) may specify 32K data transfers in each parameter set. When • 
communicating with a Fastrand subsystem it is very desirable to limit 
l/O buffers and logical increments to multiples of 33 words * This . 
rule is particularly important on WRITE functions, for the handler 
must insure the integrity of the entire sector. 

The handler will allow a program to read an entire file with one 
packet submission, providing the above restriction is not violated, ' : 
regardless of the number of times that the file is split. A split 
file is a storage area which is contained in more than one continuous 
mass storage area. 

The handler will maintain a table indicating the angular position 
of each drum unit under its control. Via this table it will attempt 
to queue each Command Word List in such a manner as to minimize 
latency. From this table, and the hardware function generated, the 
handler will compute the Start-Stop^ time of each Command Word List 
and cause it to be queued for execution at the earliest possible time 
providing its execution does not usurp a time interval allocated to 
a previously queued function. The RASL will aid the algorithm hy 
unique entry for each subsystem unit containing parts of a file. The 
handler will account 'for files contained on two cylinders of a Fastrand 
unit. 



*Start time is that time at which a function must be issued. Stop 
time is the time when the subsystem completes the function and becomes 
available for another function. 
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Tables used by the handler and labels used -to reference the tables, 



Label 
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KSBREG 
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KSEC 
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CMNUMBER 
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MSA & KSAREG 
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LI & KSQREG 
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KSCM 
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Prog* Iiock Reg; 
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Error Counter 
# of CM. Words, I. 



B2 
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Status Code 
Additional Informat:i'n 
CM Allocati:n 



Bit 2^° of word 13 = 1 indicates an intei'iock status, 
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Gore Module (Preliminary) 

Twenty-two words of "free" core are requested upon entry the 

handler. The area is used in the preliminary of the packet to determine 

the number of address needed to generate the Command Word Li8t(s)» 

If the number of words needed does not exoeed 22 the same area is 

used for CWL construction. 



B1T 
B3T 

MSA1 

LIBCW 

B5I 

WORDS 



B5T 
SPLIT 



10 
11 
12 
13 
H 



Temp B1 storage 
Temp B3 storage 



Sum of mass storage add. in file 
LI + BCW I 

Initial B5 value 

Misc. 



# of CWL»8 



B5 at MSA - LI 
# of BOW'S 
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CWL 
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Core Module (Containing Coimnand Words) 
iB6 = add, of word 0) 



Add.. of "present".:BCW I 

SI store add. 
First Command word 
2nd 
3rd 

Initial Value of B5 

EOF indicator U or ^ '"■ 
(Q) at Formatter, return 

P-TinPE (^33D) W CM address 



EF 



1st BCW 



Add. of word ^ 



Temp storage of Q 
Temp storage of A 
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Core Module (at BGW generation) 
During the generation of a Command luford list B6 equals one of two values: 
(l), it equals the add of the first word of the Core Module, (2) it 
equals the add of the BCW being generated. Under condition #1 the above 
labels eu:e used. Under conditions #2 the following labels are used. 
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Unit Control Block 



iOJCCH & KUCPTYPE 2 
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PTYPE . . |gh# |CS# 
CGB Allocation 



First Logical Address of unit 
First Hardware Address of unit 
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Mass Storage Handler 
(FH880 Drum) 
Notes; LI - Logical Increment as given in a packet • 
RASL - Random Access Storage List. 
lOD - I/O Director 

BOW - Itober of data words to be transferred. 
CWL - Command Word List(s) , 
SMOD - Storage Module 

CM - Core Module (contains CWL) 

FS - File Size as stated in the number of 30 bit words. 
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3.3.6 1 004. Subsystem Handler 

3. 3. 6,1 • Introduction 

This document outlines the specifications for the U-4.94. OMEGA On-Line 
1004 Handler and includes utilization of U-1004. Option 86. 

3.3.6.2. U-1004 Option 86 

The following three (3) features are included in Option 86: 

A. External Interrupt - This feature enables timely and accurate 
status reporting by the U-1004 to the U-494 Central Processor (s) 
in the multi-prograimned and/or multi-processor environment. The 
feature permits absolute control during "error" conditions that 
can occur in the U-1004 and enables the necessary synchronization 
for operations in this type system. 

B, Stop-Disable - This feature enables the U-1004 to maintain program 
control during a card reader, card punch, or printer error/faiilt 
conditions, while disabling the "stop" these conditions normally . 
cause. The operator can recover the error condition and process- 
ing can continue, 

C'» Punch Select — This feature enables automatic recovery from 
"punch-check" errors. The card following a mispunched card is 
selected along with the card in error. Recovery is programmed 
from the resultant error signal. No operator intervention is 
required and the correct card sequence is maintained in the 
output stacker. 

3.3*6,3. Operations 

The operations of the U-1004 handlers will be compatible with the 
HSP and the Card Reader/Card Punch handlers insofar as the user is 
concerned, 

A. Printer Operations ■" 

This operation duplicates that of the HSP operation. Form control 
is specified by the user through the OMEGA ASG| operator, wherein 
the user specifies the number of lines in the top and bottom 
margins and the number of printable lines per page, i,e., ' 
TM+BM4Pli=Total number physical lines per page. The absence of • 
these parameters in the ASG$ operator will indicate "No Form 
Control" and the hahdler will consequently relinquish form control 
to the user. 
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When form control is specified in the marginal and printable line 
information will be maintained in. the Unit Control Block (UGB) . 
A "current" line counter is also maintained in the UCB. The 
introduction of a new ASG$ operator will cause the UCB to be 
reset for form control. 

The OMEGA WRITE| operator is the only function acceptable for 
printer operations on the on-line 1004* Any other operator • 
usage will result in an Inappropriate Function Status, 

A maximum of 132-10 characters will be printed per line. The 
"Stop!' code (77) will be honored. 

Spacing with printing will be specified by the user within the 
OMEGA WRITEl operator (# of Words). Spacing on the U-1004 printer 
will occur before printing of the line. A space count of zero (0) 
will be honored, thus enabling over-printing. The maximum number 
of lines that may be spaced within one command is 63-|o=77g. Where 
the space count exceeds the number of printable lines remaining 
on a page will be interpreted by the handler as advancement of 
the form to the first logical print line on the next page. 

Where form control has been specified by the user, the following 
operation will be honored by the handler. The user may "HOME" 
form (page eject) by setting the OMEGA WRITE$ operator (# of words) 
to 4OOOO3, The handler will initiate spacing to the first physical 
line (fold) of the next page. 

The handler will also honor a "SPACE ONLY" form request from the 
user (with or without form control) . The user may "SPACE" form 
by setting the OMEGA WRITER- operator (# of words) to 2OOSS3, where 
SS is spacing 163-] 0=773. No printing will occur during execution 

f^-P +V<-? ci •«Q/-,-nQo4- r^y^ +V10 TT_-inn/ T\Tn'P'tr. ^T'Ua-r>o. ■P/'^-mr, nr\->'\4--r*rsl Vine. 'Kaai-. 

specified a "SPACE" instruction which carries into or beyond either 
margin of the current page will be interpreted by the handler as 
advancement of the form to the first logical print line on the 
• next page and an appropriate spacing instruction will be issued 
in this case. If the user is desirous of spacing to the middle 
of the next page, for example, he must request a "HOME" form and 
then request spacing to the middle of the page along with the print 
line to be printed at that point, or must break the "SPACING" into 
two "SPACE ONLY" requests, the first of which carries into a margin. 

The handler will convert all space counts from octal to decimal 
to XS-3, or 90 column code for presentation to the U-IOO4.. 

The handler will convert all print data from Fieldata to XS-3, 
or' 90 columai code for presentation to the U-1004* 

B, Card Operations 

1) Card Reader Operations 

Cards will be read in either 80 or 90 column format and in 
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either XS-3 or binary code. The user will specify which 
code he desires to be read through the OMEGA ASG$ operator. 
The UCB will contain the format of the U-1004> i.e., whether 
it is a 80 or 90 column model, A mode indicator will be 
set in the UCB to key the handler to the ^'Translate" or 
"No translate" mode for XS-3 or binary code respectively. 
In the "Translate" mode the card image will be converted 
from XS-3 or 90 column code to Fieldata Code before presenta- 
tion to the user. In the "No translate" mode the card image 
is pres@nt@d sxaotl/ as reoeivede 
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Single image card reads are possible through the OMEGA 
READ$ operator. Multiple image card reads are possible 
through the OMEGA MREAD$LIST operator. Any other operator 
usage will result in an Inappropriate Function Status. 

2) Card Punch Operations 

Card images to be punched will encompass the same features 
as explained in the Card Reader operations above, except 
that "Multiple" punch operations are not available in 
OMEGA. 80 or 90 column format and XS-3 or binary code will 
be processed by the handler. Data to be outputted to the 
U-1 004. Card Punch will be translated from Fieldata Code 
to XS-3 or 90 column code, or translation will be bypassed 
in case of binary code. 

Single image card punch operations are possible only by 
use of the OMEGA WRITE$ operator. Any other operator usage 
will result in an Inappropriate Function Status. 

3.3,6.4.» Buffer Operations 

A. Printer Operations 

The Print Handler will be assigned a 28^ g word buffer as an 
integral part of its core module by the I/O Director. A 
maxxmuiu uj. i.^'^'ir] uaua uiicij. au uox o wIjuj. ce moveQ irom wiis user 3 
buffer to the print handler buffer for output to the on-line 
1004 printer. Detection of the "Stop" code (77) will abort 
the data move at that point. Thus a user need not necessarily 
provide a 132^q character buffer. 

B, Card Reader Operations 

The user will furnish the input buffer (s) either as an integral 
part of his program or which he has acquired from an OMEGA core 
chain, • The following MINIMUM size buffers are required; 



1) Single Image Card Reads 

Translate Mode must be > I61Q 
No-translate mode must be 2. 32iq 
Translate Mode must be 2 1^10 
No-translate Mode must be ^ 18^q 

2) Multiple Image Card Reads 

a. 80 Col, Translate Mode must be > n(l6-io) 

b. 80 Col, No-translate Mode must be > n(32-jQ) 

c. 90 Col, Translate Mode must be 2 nTl8^o) 



a. 


80 Col, 


b. 


80 Col, 


c. 


90 Col, 


d. 


90 Col, 



d* 90 Col, No-tranalate Mode must be ^ 



n(l8io) 
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where n = the number of card images when using the MREAD$LIST 
operator. In this multiple read packet n buffers are specified 
each of which must be 2 l6(or 18) . 

One big buffer which must accomodate all card images is not 
required I 

C, Card Punch Operations 

The Punch Handler will be assigned a 35-jq word buffer as an 
integral part of its core module by the I/O Director. A maximum 
of 80-jo or 90 10 characters will be moved from the user's buffer 
to the punch handler buffer for output to the on-line 1004 card 
punch. The size of the user buffer is entirely optional by 
specifying number of words in the OMEGA WRITE$. operator. The 
handler will move only the number of words specified and will 
space-fill any remaining area in the output bufffer, 

NOTE:' Inconsistencies in buffer sizes by the user will in all 
instances result in an Inappropriate Buffer Status, 



3.3.6.5. U--494. Status Codes 



The following status codes will be provided by the Handlers to the 
OMEGA I/O Director as a result of interrupt/error analysis^ 

RA of SmD - = Sucessful Completion 

RA of SMOD = 4000000001 = Inappropriate Function 

RA of SMOD = 4000000002 = Inappropriate Buffer Size 



3*3.6.6. U-494 Instructions to On-line U-1004 

Instruction formats are based on the following scheme in the low 
order five bits of the instruction word: 



20 = 

21 = 

22 = 

23 = 

24 = 

25 = 



= Read 

= Punch 

= Print 

= No-translate J = Translate 

= 90 Column; = 80 Column 

= Space 



The following constitute valid instructions acceptable to the on-line 
U-1004. 



A. 80 Column 
OCTAL 



40000 00001 
40000 00011 



DESCRIPTION 

Transfer card read image (XS3) to U-494 
Transfer card read Image (CI) to U-494 
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OCTAL DESCRIPTION 

40000 00002 Transfer card punch image (XS3) to U-1104 
40000 00012 Transfer card punch image (Cl) to U-1004 
4XXXX 00004 Transfer Print Line to U-1104; spacing 

XXXX (XS3) decimal equivalent) before printing, 
4XXXX 00044 Transfer space count XXXX (XS3 decimal 

equivalent) to U-1004 and space printer 

XXXX lines. 



B. 90 Column 

OCTAL 



40000 00021 
40000 00022 
4XXXX 00024 



4XXXX 00044 



DESCRIPTION 

Transfer card read image to U-494 
Transfer card punch image to U-1004 
Transfer print line image to U-10045 space 
XXXX (90 Col decimal equivalent) lines 
before printing. 

Transfer space count XXXX (90 Col decimal 
equivalent) to U-1004; and space printer ' 
XXXX lines. 



3.3,67. External Interrupts From U-1004 to U-494 
OCTAL DESCRIPTION 



6XXXX OOOFG 



/WW nr\r\j i 



U-1004 cannot perform the requested function. 
2^3 of the instruction word received is set. 
and the instruction word is returned to the 
U-494 by the U-1004. This is termed a 
"reject interrupt"* 

Space only instruction accepted and executed 

by U-1004. 



3,3.6.8. U-1004 Operations 



The U-494 will control the sequence of data flow and information 
as to what must be done to this data. The U-1004 will control its 
own peripheral devices, i.e., card reader, line printer, card punch, 
and the sequence of physical input/output events. The interface 
between the two systems, therefore, is one strictly to control the 
transfer of data and instructions from one to the other. 

The U-1004 will effect data transfers immediately in most all cases. 
If it is unable to perform a requested function, an External Interrupt 
will be sent to the U-494 » indicating that the function cannot be 
performed (reject interrupt). The U-1004 will then come to an 
orderly halt to allow operator correction of the problem, e.g., out 
of paper, card hopper (s) empty, etc. 
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The U-4.94. handler, upon analysis, of the external interrupt, will 
notify the I/O Director of the "Interlock" condition. This will 
cause a console typeout and suspension of the U-IOO4. channel operations. 
When the problem has been corrected, the U-4.94. operator will respond, 
via the console typewriter, that the problem is corrected. The IJ-1004, 
channel will then be reactivated and the I/O Director will resubmit 
the same request to the handler and U-IOO4. operations will resume from 
where they were discontinued. An illegal function code will cause 
the 1004, to aend a reject interrupt. 

The following operations will be performed by the U-IOO4.; 

A. Space and Print - the OMEGA on-line 100A handler will activate 
■ a 28-jo word output buffer. The U-1004 will accept the first 

word of this buffer, decode it and, if no previous print line 
is waiting, execute the form spacing specified. The following 
27-10 words will then be accepted into working storage. If a 
print line is waiting in print storage, the new print line will 
be transferred into working storage la card will be read if 
desired) before the waiting line is printed. 90 column code 
will be printed when operating in the 90 column mode. 

B. Space - The U-1004. will receive a one word instruction from the 
U-4.9^. If no previous print line is waiting to be printed, the 
spacing of the form will be executed. An external interrupt 
will then be sent to the U-4.94. j acknowledging the execution of 
the specified form control. If a print line is waiting to be 
printed, the line will be printed (a card will be read if desired) 
and the form control (space) instruction executed. As above, 

an external interinipt will now be sent to the U-494- 

C. Read - the U-IOO4. will receive a one word instruction, decode it 
and transfer the card image to the U-4.94.. The U-IOO4. will then 
determine whether or not an I/O function must occur to have 
another card image available for the U-4.94.. If so, another 
card will be read and the U-IOO4. will await receipt of the next 
instruction. The instruction will define the code to be read, 
i.e., XS-3, Code image, 90 columai code. 

D. Punch - the OMEGA on-line 1004 handler will activate an output 
buffer of adequate size to accomodate XS-3, code image or 90 
column code. The U-IOO4. will accept the first word of the 
buffer (instruction word decode it and wait for the punch to 
complete a prior task, if any, and then accept the remaining 
punch data words. The U-IOO4. will then start to punch the data 
and will await receipt of the next instruction. The instruction 
word will define type of code for the U-IOO4.. 
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1004 PRINTER UNIT CONTROL BLOCK 



WORD 








RIR SETTING 
OF HANDLER 


1 


• 


UCB LINK 


2 


PERIPHERAL 
TYPE 


CHANNEL / 
UNIT 


3 




LINKING ADDRESS 
TO CCB 


U 


LENGTH OF 
UCB dig) 


NO. REQUESTS 
TO CCB 


5 


MIN. SIZE OF 
CORE MODULE 


INTERRUPT 
TSET 


6 




REQUEST QUEUE 
(HEAD OF CHAIN) 


7 


MODE INDICATOR 


10 


UPPER 
MARGIN 


LOVJER 
MARGIN 


11 


CURRENT PRINT 
POSITION 


# OF PRINTABLE 
LINES/PAGE 



NOTES: WORD 7 - 2*^^ = 1 = 90 COLUMN 

L(W0RD 11) = ^ =. NO FORM CONTROL 
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1004 CARD READER UNIT CONTROL BLOCK 



WORD 



i 





RIR SETTING 
OF HANDLER 




UCB LINK 


PERIPHERAL 
TYPE 


CHANNEL/ 
U^TIT 


LINKING ADDRESS 
TO CCB 


LENGTH OF 
UCB (IO3) 


NO. OF REQUESTS 
QUEUED TO CCB 


MIN. SIZE OF 
CORE MODULE 


INTERRUPT 
TSET 


REQUEST QUEUE 
(HEAD OF CHAIN) 


MODE MULTIPLE READ 
INDICATOR 1 COUNTER 



NOTES: WORD 7 - 2^^ = 1 = 90 COLUMN 

228 - 1 - IK) TRANSLATE 
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1004 CARD PUNCH UNIT CONTROL . BLOCK 



WORD 

1 

"2 
3 

5 
6 
7 





RIR SETTING 
OF HANDLER 




UCB LINK 


PERIPHERAL 
TiPE 


CHANNEL / 
UNIT 




LINK] 
TC 


:NG ADDRESS 
) CCB 


LENGTH OF 
UCB dOg) 


NO. OF REQUESTS 
QUEUED TO CCB • 


MIN. SIZE OF 
CORE MODULE 


INTERRUPT 
TSET 




REQUEST QUEUE 
(HEAD OF CHAIN) 


MODE INDICATOR 



NOTES; WORD 7 - 2^9 = 1=90^ COLUMN 

228 = 1 = NO TRANSLATE , 
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WORD 



1004 PRINTER GORE MODULE 



FOR HANDLER USE 



INTERRUPT STORE ADDRESS 



PRINT COMMAND , 



STORAGE FOR INTERRUPT STATUS 
STORAGE FOR INPUT BGR 
STORAGE FOR OUTPUT BGR ' 

PRINT BGW 

PRINT INSTRUCTION 



34 



27,^ WORD PRINT LINE 
^^ BUFFER 
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1004 CARD READER CORE MODULE. 



WORD 




1 
2 
3 

5 

o 

7 

10 

11 

12 



FOR HANDLER USE 



INTERRUPT STORE. ADDRESS 



READ COMMAND 



INPUT BUFFER COMMAND 



STORAGE FOR INTERRUPT STATUS 
STORAGE FOR INPUT BCR ' 
. STQPJIGE FOR OUTPUT BCR 
READ BCW 



READ INSTRUCTION 



INPUT BCW 



MULTIPLE READ LIST POINTER 
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WORD 



1004 CARD PUNCH CORE MODULE 



1 
2 
3 
4. 
5 
6 
7 



FOR HANDLER USE 



INTERRUPT STORE ADDRESS 



PUNCH COMMAND 



STORAGE FOR INTERRUPT STATUS 
STORAGE FOR INPUT BCR ' 
. STORAGE FOR OUTPUT BCR 
PUNCH BCW 



33, Q WORD PUNCH BWFER 



4.7 



NOTE; BUFFER ACCOMODATES EITHER 
80 OR 90 COLUMN U-1004, 
OR BOTH. 1st WORD OF 
BUFFER CONTAINS PUNCH • 
INSTKUCTION, 



3.3.6-13 



3.3.6.9. I/O STATUS .CONDITIONS 



^.^^ REGISTiilK A 
^\.,^^ AND/OR 

^\^ REGISTER B6 
^^>.^ATUS ■ 

OP CODE ^\^^^^ 


g 

1: 


j^1 INAPPROPRIATE 
FUNCTION 


ft, 

ft, s 


o 
o 

t 


80 Coltmm 




2 


3 


4 


READ XS3 - JZ51 


READ BINARY - 11 




2 


3 


k 


PUNCH XS3 - pl 




2 




4 


PUNCH BINART - 12 




2 




4 


PRINT - ply 




2 




4 


SPACE - 4^ 




2 




4 


90 Column 




2 


3 


4 


READ 21 


PUNCH 22 




2 


3 


4 


PRINT 24 




2 




4 


SPACE 44. 




2 




^ 



Key to Register Values Submitted to I/O Director 

1. Normal Response. RA = JZJ 

2. Requestor has submitted invalid Function Code. RA = 4000000001 

3. Requestor has specified Input Buffer size less than minimum 
required size for type image to be read. RA = 4000000002 

4. The requested function cannot be executed by U-1004 at this time 
due to "out of paper", "empty card hopper", etc. 
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READ/PRINT HANDLER 



BOLTOO 




© 



Yes No 



Sprint? ^W^ . Ctime out? J '^X^ 

No P^^® ^ 



/^MULTIPLE \e/7\ 
V READ? J \^ 



/fir 



No 



I^UT BUFFER 



Wge enough A"{ h 




No 



Yes 



/ DEVELOP \ 
\ BGR / 



© 



/■MT!PTATT«7'tfs, 

X ■<- .LI U. .L. J. XIXJU. fJXJ X 

\' CORE / 



© 



queue 

^request to 

' channel b2 

^KTORTTY 



SUBMIT 

REQ. 
UEST TO 
i'ORMATT] 




^Z/ 



a 



TRANSLATE? Wo 



Yes 




D 



IANSLATE> 

INPUT 

IMAGE 



© 



/multiples 

V READ? J 



No 




SET 
"NORMAL^' 
STATUS 



RETURN 

rCONTROL TO 

iREQUESTOI 
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© 



© 



SET 

"INAPPROPRIATE" 
STATUS 



r REJECT ^f2/0 
V jNTERRUPT? J \r ^ 



Yes 



RETURN 
CONTROL TO^ 
SQUESTORy 



© 




SET 
"INTERLOCK" 
STATUS 



/input , BUFFE\_y^' 
VLARGE ENOUGF V^ J 




/So 

( T 



RE MODULE \No 



. "RCR LIST 
MmELEl£2 



^ A£y 



Yes 



© 
© 



SET 
"INAPPROPRIATE 
BUFFER" STATUS 



lETURN 
CONTROL TO' 
3QUEST0R, 



RETURN 
CONTROL TO 
DIRECTOR 



© 



Z'^ME" FORM 
V FUNCTION? 



No 



/^^SPAGE" FO 

V JNSTRUGTI ON 

I No 

IS FORM AT1s^ 
HY SICAL LI 

I Yes 




ADD TOP 
MARGIN TO 
SPACING 



SET FORM 
CONTROL TO LOG- 
ICAL PRINT LINl 



(t) 



/Format 
/print/space 
n^nstruction 



MOVE 
^PRINT LINE' 
TO GORE 

^£ML£- 



/translateX 




SUBMIT 
PRINT REQUEST 
TO I/O 
F0-R>4ATTER / 




■0 



© 



/^EXTERNAL ^Yes^~^ /Is SPACING ^ No /-^ 

VINTERRUPT?> — ^I ) X.NTO MARGIN?y (r) 

No ^-^page 1 I Yes ^""^^ 



S SPACING 
WTO MARGIN?, 



V JIMED OUT? > ^^j) 
No 



© ■ 

^— ^page 1 



:S FORM AT 1st 
'HYSICAL LI 



Yes 



- DJiViiiiUr 



FULL PAGE 
SPACE 
JNSTRUCTION. 



O 




DEVELOP 
PARTIAL 
PAGE SPACE 
J^JSTRUCTION 





page 1 
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DEVELOP \ 
SPACING TO \ 
n LOGICAL / 
LINE / 




© 



/DEVELOP \ 
/SPECIFIED \ 
\ SPACING / 

\INSTRUCTI0N / 



© 






^ 
^ 



OES SPACING 
ARRY INTO MARGI 



Yea 



^ 



DEVELOP 
^SPACING TO^ 
LOGICi 



© 



PUNCH HANDLER 



BOLTOO 




INITIALIZE 
GORE / 
IQDULE / 



^ 



TRANSLATE? iMo 



Yes 




/translate \ 







/ submit 
/ punch request 

\ TO I/O 

\ irnRMflTTER 



© 



© 



SET 
"NORMAL" 
STATUS 



iTURN 
CONTROL TO) 
SQUESTOI 






SET 
"INAPPROPRIATE 
FUNCTION" STATUS 



'^RETURN 
)NTROL TO 
iQUESTOI 



© 



/"EXTERNAL X^^^^ ' 

V interrupt/^ D ) f 



REJECT 
NTERRUPT? 



I Yes 

VTIMED OUT J \^^J (e) 

I No • ^""^ 1^ 




Nq 



SET 
"INTERLOdiC" 
STATUS 



/RETURN \ 
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i^'.4 Auxiliary Koutines 

In order to conserve the amount of core memory required by CMEGA, 
certain auxiliary l/O routines are drum stored. These routines 
are loaded into core when they are needed and remain as long as 
they are active. Included in this group are the following: Error 
Recovery Routines, Interlock Routine, Search Routines, and Peripheral 
Initialization Routines. 

3.4.1 Error Recovery Routines 

Error Recovery Routines, such as magnetic tape recovery 
involving a change of tape direction, are re-entrant routines 
listed with the Content Supervisor, 

Entry 

The appropriate Error Recovery Routine is entered from the 
Device Handler 1:^ a call to the Content Supe^isor identifying 
the routine to be loaded. The call is shown below: 



EXRN 



Vq 



where Vpj is the mnemonic name of the appropriate Error 
Recovery Routine (this name will be equated to 
the correct Secondary Exec Library No. and 
function code) . 

When this call is made a Storage Module is allocated and 
linked to the Activity Addendum. Error Recovery receives 
control with the absolute address of the allocated S-mod 
in B4, The handler may set up parameters in the registers 
which may then be accessed by Error Recovery" through the 
S-mod. The Storage Module assigned when the activity issued 
the l/O request is the next S-mod on the chain and its address 
may be found in the PUSH/POP Link location of the S-mod 
indicated by B4. 

Exit 

After performing its functions the Error Recovery Routine 
returns control to the Device Handler. Control is returned 
'through the Content Supervisor by the packet shown below: 



ENT^^BI 


c( i^ !zf ef 0' 


DRET1$ 


ii i ^ i 2 



Control is returned to the handler at the location following 
the call. Registers are restored to their value at the time 
Error Recovery was called unless they are changed in the S-mod 
by Error Recovery (the success or failure of the recovery 
attempt may be indicated in the A and/or Q register position 
of the S-mod). 
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uperaxion . . 

Error Recovery examines the hardware status code(s) to 
determine the proper recovery procedure. Error Recovery 
may then obtain an area of free core to set up the recovery 
functions, or it may resubmit the original module which 
was set up by the Device Handler, or it may do both. For 
example, the magnetic tape recovery routine may obtain 
free core to set up the repositioning functions and then 
submit the original function* Error Recovery Routines submit 
functions directly to the Formatter as do .the Device Handlers, 

3.4.«2 Interlock Routine 

The Interlock Routine, as the Error Recovery Routines, is. 
a re-entrant Secondary Executive Routine listed with the 
Content Supervisor* Its purpose is- to provide- a common 
routine which will handle interlock type out messages for 
the Device Handlers. 

Entry 

The Interlock Routine is entered by the Device Handlers 
through the call to the Content Supervisor shown belows 



EXRN^^INLK 



where "INLK" is the mnemonic name of the Interlock Routine. 
This name will be equated to the Secondary Exec Library, 
number and function code of the Interlock Routine. 

Before calling the Interlock Routine, the Device Handler 
must set B5 equal to the absolute address of the Unit Control 
Block of the interlocked device. This parameter is used to ' 
identify the channel and unit of the device. 

Exit 

The Interlock Routine returns to the Device Handler at the 
location following the call when the operator* has answered 
the type out. Return is made through the following packet: 



ENTi^BI 



DRET1$ 



^ i t iji 
P 2 



All registers will be restored to their value at the time of 
the call with the exception of the A-register which will 
contain a status code: 
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0*0 0" the interlock condition has been 

corrected. 

1 1 1 1 l^U ^ 1 - the interlock condition cannot be 

corrected. 

Operation 

The Interlock Routine obtains an area of free core and builds 
the interlock message in this area. The channel and unit 
contained in the Unit Control Block, identified by B5, are 
placed in the message area. The message is then given to the 
I/O Director for assigning a response number and placing oh 
the console output queue (see Section 3»2.2). The output 
message will take the following form: • 

"INTERLOCK CXX UYY DZZ" 

where XX is the octal channel number 
lY is the octal unit number 
ZZ is the response (delay) number 

When the operator has responded control is returned to the 
Interlock Routine with the input message in the A-register. 
The routine then stores the appropriate status code in the 
A-register position of the S-mod (address in B4.) and transfers 
control, through the Content Supervisor, to the I)svics Handler , 

The operator response to the interlock message is of the 
following form: 




where ZZ is the response number of the interlock type out, 

Y is entered if the interlock has been corrected. 
The handler will resubmit the function to the 
Formatter. . ., 

N is entered if the interlock cannot be corrected . , 
The handler will return an error status to the , 
requesting activity. 
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3.4-»3 Search Routine 

The Search Routine is a re-entrant Secondary Executive 
Routine listed with the Content Supervisor. Its purpose 
is to provide a software simulation Of those hardware 
search functions which may unduly monopolize a peripheral 
subsystem for extended periods of time. 

Entry 

The Search Routine is entered by a call to the Content 
Supervisor generated in response to certain search mnemonics. 
These mnemonics generate standard l/O packets (See Section 3«5»2) 
with the call directed to the Content Supervisor instead of 
the I/O Director, The following mnemonics will cause entry 
to the Search Routines 

search! - generalized search, tape or mass storage. 

SEARCHLl - same as above with logical lock of mass 
storage. 

BLOCKSLI - block search with logical lock (drum 

. subsystems only) 

SEARCHTLl - search track with logical lock (FASTRAND 
subsystems only) 

SEARCHPI4 - search position with logical lock (FASTRAND . 
subsystems only. 

The BLOCKS!, SEARCHT^, and SEARCH?! operators (as above only 
without logical lock) are hardware search functions'. Their 
counterparts with logical lock must be software searches sinc6 
the find address is not indicated by the hardware on search 
read operations. The area is locked only if a find is made. 

Exit • ' 

At the completion of its operations the Search Routine places 
status information in the A and Q" registers of the Storage 
Module associated with the operation (address in B4 at entry) 
and exits to the calling routine through the .Content Supervisor 
with the following packet: 



ENT*B1 


ef iZJ el (2i gJ 


DRET1! 


g( ^ el 2 



status information returned by the Search Routine is given in 
Section 3«5»3. 
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Operation 

The Search Routine issues Read functions to the l/O Director 
in the normal manner. The parameter packet, including 
buffer, is the search packet. For tape searches the first 
word of the buffer is compared to the search identifier; for 
mass storage searches each word of the buffer is compared 
to the search identifier, , Repetitive reads are given by the 
Search Routine until either a find is made or an error 
condition occurs. 

When a find is made on a mass storage search another Read 
(with or without lock, as appropriate) is initiated beginning 
with the find address. The actual functions performed for 
the various search operators are given below, 

• SEARGH$ - READI functions are given. When a find is 

made control is returned (magnetic tape) , or 
another READ$ is given beginning at the find 
address (mass storage) • 

• SEARCHL$ - READ$ functions are given. When a find is 

ma(fea READL$ is given beginning at the find 
address. 

• BL0CKSI4 - BLOCKRf functions are given. When a find 

is made a BL0CKRI4 is given beginning at 
the find address. 

• SEARCHTLl - READ$ functions are issued. When a find is 

' made a READI4 is given beginning at the find 
address. 

• SEARCHPLl. - READ$ functions are issued. When a find is 

made a READI4 is given beginning at the find 
address* . 
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3. 4*4 Peripheral Initialization 

Peripheral Initialization Routines are drum stored routines 
called by Facility Assignment to assist in setting up the 
Unit Control Block and to perform any functions required for 
the initialization of the peripheral device. The Initialization 
Routine to be used with each Device Handler is indicated in 
the Handler Description (See Section 6.6) . 

Entry and Exit 

The Initialization Routines are entered from and exit to 
Facility Assignment via the Return Jump instruction (Facility 
Assignment is a .non re-entrant routine) • 

Operation 

As an ASSIGN statement is processed by Facility Assignment a 
Unit Control Block will be partially formed. The remainder 
of the UGB is to be set up by the initialization code for 
this peripheral type. 

Facility Assignment will: 

1. Secure core for the UCB, the number of words will be 
specified in the Unit Descriptor. 

2. Set up the first 7 words of the UCB which are similar 
for all types of devices. 

3. Will load the initialization code which was specified 
with the handler of this peripheral. 

4. Form a buffer containing Assign and Unit Descriptor 
information. 

5. Enter the initialization coding b^ a. Return Jump 
instruction. 

Initialization Entrance Parameters: 

B1 = 15 bit address of a buffer which contains Assign 
information and the Unit Descriptor. 

B4 = Storage Module address. This value must be retained. 

B$ = 17 bit address of the Unit Control Block which is ' 
being formed. 

Initialization will interpret the option and estimate information 
from the Assign statement in conjunction with the -Unit Descriptor 
to form the UCB word 7 and on up. , Any required initialization 
functions such as clear card memory should be performed at this 
time. 



3.4-6 



The operator may be notified of any abnormal conditions by- 
forming a LOG statement in a buffer obtained from free core. 
The buffer with the LOG statement will be passed to Facility- 
Assignment as the Initialization exits. Exit is by a JP 
to the L(RJP entrance location) with appropriate exit parameters. 

Upon receiving an error status from the initialization routine 
facility assignment will submit the message generated by the 
initialization routine to the LOG routine for processing. 
Control will be returned to the requestor of the assignment 
from the LOG routine with the appropriate status of the 
assignment.. 



Initialization Exit Parameters 

: REG A = 00000 00000 Successfully completed 

REG A = 77777 40000 Unsuccessful - Reject. ASSIGN request 

REG A = 77777 40001 Unsuccessful - Perform a LOG operation 

(Console typeout to operator) and release 
LOG buffer back to FREE CORE. 

B7 = Absolute memory address of the UjQ 
statement which is to be typed out. 

Q = LOG message length - number of words. 
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ASSIGN Mhu unit DESCRIPTOR BUFFER 



B1 POINTS 
TO HERE 




1 
2 

3 
4 
5 
6 
7 
10 
11 



OPTIONS 



ESTIMATE (1st WORD) 



ESTIMATE (2nd WORD) 



ESTIMATE (3rd WORD) 



P-TYPE 



LENGTH OF U.D. 



CH/UNIT 



CH/UNIT 



LENGTH OF U>G.B> 



DEVICE DEPENDENT 



INFORMATION 



FROM THE 

ASSIGN STATEMENT 



UNIT DESCRIPTOR 
AS LISTED IN THE 
FACILITY MAP 



Options - Master bits set to 1 to represent the alphabetic 

character ogtions contained in the ASSIGN statement* 
2^9 = A, 2^^ = B, -2^ = Z 

Estimate - Binary representation of the estimate parameter of 
the Assign. statement. 

The estimate field from the Assign statement may 
consist of up to three parts. ( . 1 / 2 / 3 « ) 
Each part will occupy one word in the estimate storage 
set up for the initialization routine. Any part which 
is not present will cause all 7 — ^7.'s to be placed in 
the appropriate word in the estimate storage,. 
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An additional "Initdalization Routine" is operated as a 
segment of the Facility Release Routine, The purpose of 
this initialization is to "clean up" the device in antici- 
pation of the next assignment. 

The segment is called when Facility Release detects 2^ 
set in the UCB word containing the peripheral type code. 
This bit is set when the UCB if formed depending on a 
control bit in the Handler Description. 

The action taken by this "Initialization Routine" is 
dependent upon peripheral type as follows: 

• Standard Card Punch - Punch three blank cards so that 
the last card punched by the user is error checked 
and an automatic run-out is achieved. 

• 1004 Card Punch - Punch two blank cards so' that the 
last card punched by the user is error checked and an 
automatic run-out is achieved. 

• High Speed Printer - Space paper to the first physical 
line of the next page. This is done only if a page 
length has been specified and the paper is not already 
at the Home Paper position. 

• 1004. Printer - Same as High Speed Printer. The Home 
Paper function will force out the last print line which 
is held in 1004- memory. 
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3.5 User Interface 

3* 5.1 File Codes 



•File codes represent the basic mechanism by which an operating acti- 
vity communicates l/O requests to the system. At time of activation 
by control card or through internal request, the user expresses the 
type of unit:or random access file to be assigned to the file code. 
Once established the user presents the file code \*ith each l/O packet 
submitted to the system and thereby making the object code relatively 
independent of device. 

Each task addendum is provided with a basic set of 25 file codes, A 
through Y, to which the user may assign peripheral devices or random 
storage files. In cases where these are- insufficient, the user may 
specify that a designated file code is to be fragmented into an 
additional 26 codes which would contain the same characteristics as 
the original set. 

Examples If the file cod© B is fragmented, the new set would be 
referred to as BA, BB . . . BZ 

File code Z of the basic set is reserved for systems references and 
is fragmented as such: 



File Code Reg9i-Y^(^ Usq 

ZA Unit record primary imput 

ZB Unit record primary output 

ZG Unit record secondary output 

ZD Cooperative Library 



ZE Systems Library 

ZF Job Library 



The only routines eligible for referencing these file codes are 
those contained in the systems library », 
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3.5.2 I/O Requests 

OMEGA I/O requests are generated in response to mnemonics consisting 
of an operator and a specification list. The operator defines a 
specific executive call and function code. A parameter packet is 
formed from the specif ication' list of the request. The general 
fonnat is given below. 

Opera torl^Specif ication, Specification . ► . 

where the specification list could contain any following dependent 
upon operation or device 

Vq - File Code - is an alphabetic code identifying the logical unit 
referenced. 

V-j - # of words - specifies the length of the data buffer. Length 
for any one buffer is limited to 4-2. 

V2 - Buffer base - contains address of buffer relative to lower lock 
setting of activity. 

V« - Logical address - increment from base of file normally used 
with random access storage references; but may be present 
with sequential files to effect device independence. 

Vi - Search word - 10 octal character number giving search identifier 
to be used in a search operation. 

The following is a summary of the basic set of l/O operator recog- 
nized by the system, their function codes, specifications and appli* 
cable devices. This is followed by a more detailed description of 
the s''^ec-ific- o""6rator and ■•^rameter packet. 
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I 



Function 


Random Access 


V-Operands 


Code 


Operators 


Used 


01 


READ$ 


0,1,2,3 


02 


write! 


0,1,2,3 


03 


BLOCKRi 


0,1,2,3 


04 


SEARCHT$ 


0,1,2,3,4 


05 


SEARCHPl 


0,1,2,3,4 


06 


SEARCH^ 


0,1,2,3,4 


07 


BLOCKSl 


0,1,2,3,4 


10 


READB$ 


0,1,2 


11 


readlI 


0,1,2,3 


12 


WRITERS 


0,1,2,3 


13 


BLOCKRLl 


0,1,2,3 


U 


SEARCHTL^ 


0,1,2,3,4 


15 


searchplI 


0,1,2,3,4 


16 


SEARCHL$ 


0,1,2,3,4 


'17 


BLOCKSL^ 


0,1,2,3,4 


20 


WRTEOFI 





21 


REWIND^ 





22 


REWINDll 





23 


ERA.SE$ 





2A 


SREAD$ 


LIST 


25 


GWRITE$ 


LIST 


26 


MREAD^ 


LIST 



Notes 



& 3 
& 3 

& 3 




Note 1 FH-880 Drum only 

2 FASTRAND only 

3 Directed to the Content Supervisor 

4 Function returned as "Successful 

completion" 



Note 5 V-Operand is a tag defining a list packet 
6 Backspace Block on IIIC/lVC 



Sunnnary of Unit Record Equipment 



EauiDment Troe 


Function 
Code 


Operator 


V-Operands 
Used 


Card and Paper Tape 
High Speed Printer 


01 
02 

02 


REM)$ 

WRITER 

MREAD$ 

WRITE$ 


0,1,2 
0,1,2 
Tag 

0,1,2,3* 



* Specifies number of lines to space before print 



General l/O Operators: 

, READ - directs the system to transfer data from specified peripheral 
device to indicated core buffer. If peripheral device is random 
access storage number of wcrds transferred will be that specified 
as buffer length. If UNISSRVO or unit record device is assigned 
number words transferred will be that specified as buffer length 
or when end of block or record is reached. The BEAD operator is 
as follows: 

READ$Afile code, § of words, biiffer base, logical address 



Packet 



N 



EBJP*B7 


N 


FILE CODE 


1 # OF WORDS 


BUFFER BASE 


• LOGICAL ADDRESS 


EXRM 


10 Oil 



U ixecuiiive iuiTiry 
instruction 



WRITE - data from specified buffer is transcribed to storage. The 
user must maintain a logical address, i.e., is the sum of words 
written. This address will be used in the event the file is allo- 
cated to random access storage. 

An end-of-file error status indicates that the end of allocated 
■ area has been reached. An additional area, which, is logically 
continuously addressable, may be added on request. 

The function may be specified by: 

WRITE$^File code, # of words. Buffer base, Logical address' 

Packet 



N 



SBJP^B? 


N 


FILE CODE 


# OF WORDS 


1 BUFFER BASE 


LOGICAL ADDRESS 


EXM 


110,0 


-^ 
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READL - Read lock performs the same function as READ with the 
addition that an entry for the accessed area is made on a lock- 
list. This lock will prevent any other READL function within 
this area until released. Conflicting requests are requeued 
until they can be performed. 

The function may be requested by: 

READL$Afile code, # of words, buffer base, logical address 

The specification list and packet generated are identical to READ 
except that the executive entry is generated* as EXRN*10011. 

WRITER - the write release fiinction is the counterpart of READL 
in that an area on the lock-list is released by the function within 
the area. If no write function is to be performed a release is 
effected by specifying an address within the lock area with number 
of words specified as zero. Otherwise, WRITE release performs the 
same function as WRITE. 

The specification list and packet generated are. identical to WRITE 
except that the executive entry instruction is generated as 
EXRN*10012, The function may be specified by: 

WRITER|Afile code, # of words, buffer base, logical address 

SEARCH - this function compares the first word of each block 
against the specified identifier. Reading is initiated when a 
match is made to include the search identifier within the buffer. 
If end of the file is detected a no find status word is returned. 
If mass storage the find address is returned in the A-register. 

OMEGA simulates the search function through use of repetitive reads 
to prevent undue tie-up of the synchronizer. Since the buffer for 
this function becomes the blocking factor for random storage; in 
the contingency of allocation to tape the buffer must be equal to 
•or greater than the buffer used in writing the file. For the 
contingency of allocation to FASTRAND, the buffer might, also be 
a multiple of 33 words to improve efficiency. A locate function 
on tape can be effected hy specifying #■ of words as zero. The 
SEARCH operator is as follows: 

SEARCH$^file code, # of words, buffer base, logical address, 
searchword 

Packet 



EBP^B7 


N 


FILE CODE 


# OF WORDS 


1 BUFFER BASE 


LOGICAL ADDRESS 


SEARCH IDENTIFIER 


EXRN 


2 1 6 J 



N 1 EXRN 12 1 6 1 Executive Entry 
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SEA.RCHL - search lock performs the same function as SEARCH with 
the addition that an entry for the accessed area is made on the 
lock-list when a successful search occurs. 



The specification list and packet generated are identical to 
SEARCH except that the executive entry instruction is generated 
as EXRN^20116. The function may be specified by: 



SEARCHL$Afile code, 
search word 



# of words, buffer base, logical address, 



REWIND - position file to load point* This function is ignored 
if random access was allocated. The programmer must, therefore, 
reset the logical address to zero to provide for the even of 
random storage allocation. Operator is as follows: 



REWIND$Zifile code 



ENT * B7 


FILE CODE 


EXRN 


10 2 1 



Packet 



REWINDI - rewind with interlock performs the same function as 
REWIND except that the tape is interlocked for operator inter- 
vention. This function is ignored if random access was allo- 
cated. Operator is as follows: 



REWINDI$Afile code 



ENT *B7 


FILE CODE 


EXRN 


10 2 2 



Packet 



WRTEOF - write end-of-file transcribes a point recognized as EOF 
when encountered by a read. When this operator is used to mark 
the end of recorded tape there should be as many EOF marks as 
there are standby buffers or block reads in a MREAD operator. 
This function is ignored if remdom access storage is allocated. 
The operator is as follows: 



WRTEOF^ A file code 



ENT * B7 


FILE CODE 


EXRN 


10 2 



Packet 



ERA.SE - the erase function results in erasure of a fixed area 
of tape. This function is ignored if random access storage is 
allocated. The operator is as follows: 



ERASE? A file code 



Packet 



ENT * B7 
EXRN 



FILE CODE 



.2_i 
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, READB - rdad backward function moves tape in the backward 

direction and the data enters the buffer in the order encountered 
in movement of the tape. 

The specification list and packet generated are identical to READ 
except that the executive entry is generated as EXM*100i1. This 
function is ignored is random access storage is allocated. The 
function may be specified by the operator: 

KEM)B$Afile code, # of words, buffer base 

. FH Drum - specific allocation requests for FHA32, FH880, etc., may 
be made. 1!he functions applicable to a random file are augmented 
by the following operators. 

. BLOGKR - the block read function is a READ function that is termi- 
nated by the end-of-block sentinel (all one's). 

The specification list and packet generated are identical to READ 
except that the executive entry instruction is generated as 
EXRN*10003. The function may be specified by: 

BLOCKR$^file code, # of words, buffer base, logical address 

. BLOGKRL - block read lock performs the same function as ELOCKR 
with the addition that the lock-list mechanism is employed. 

The specification list and packet generated are identical to READ 
except that- the executive entry instruction is generated as 
EXRN*10013. The function may be specified by: 

BLOCKRL$ A f ile code, # of words, buffer base, logical address 

compares consecutive words on drum against the specified identifier. 
Reading is initiated when a match is made to include the search 
identifier within the buffer. The function is terminated by the 
•. end-of-block sentinel (all one's). 

The specification list and packet generated are identical to SEARCH 
except that the executive entry instrujction is generated as 
EXRN*10007. The function may be specified by: 

BLOCKSS^file code, # of words, buffer base, logical address, 
search word 

. BLOCKSL - block search lock performs the same function as blocks with 
the addition that the lock list as described with READL is employed. 

The specification list and packet generated are identical to SEA-RCH 
except that the executive entry instruction is generated as EXRN*20117. 
The function may be specified by: 

BLOCKSL$Afile code, # of words, buffer base, logical address, 
search word 
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FASTRAKD - specific allocation requests for types of FASTRANB 
storage may be made* The functions applicable to a random file 
are augmented by the following operators: 

SEARCHT - the search track function is a hardware function which 
compares the first word of consecutive FASTRAND sectors against the 
specified identifier. Reading is initiated when a match is made 
to include the search identifier within the buffer. The function 
is terminated by the end-of-track interrupt. A locate function 
can be effected by specifying § word as zero. 

The specifidation list and packet generated are identical to SEARQi 
except that the executive entry is generated as EXEN*10004,. The 
function may be specified by: 

SEARCHT^Afile code, # of words, buffer base, logical address, 
search word 

SEARCHTL - search track lock performs the same function as SEARCHT 
with the addition that the lock-list mechanism is employed. 

The specification list and packet generated are identical to SEARCH 
except that the executive entry is generated as EXBN*20114.. The 
function may be specified by: 

DiliAxion lii^ 4U X ixa uou6, <fl> ux wuxus, uuxxex- uaSo, lugioal auuress, 
search word 

SEARGHP - the search position function is a hardware function which 
compares the first word of consecutive FASTRAND sectors against the 
specified identifier. Reading is initiated when a match is made to 
include the search identifier within the buffer. The function is 
terminated by the end— of— position interru^nt* A locate function can 
be effected by specifying # of words as zero. 

The specification list and packet generated are identical to SEARCH 
except that the executive entry is generated as EXRN*10005. The 
function may be specified by: 

SEARCHP$ii file code, # of words, buffer base, logical address, 
search word 

SEARCHPL - search position lock performs the same function as 
SEARCH? with the addition that the lock-list mechanism is employed. 

The specification list and packet generated are identical to 
SEARCH except that the executive entry is generated as EXRN*20115. 
The function may be specified by: 

SEARGHPLj A f ile code, # of words, buffer base, logical address, 
search word 
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Mnltiiple Read/Write Service Requests - the, following operators 
describe special purpose functions where data is to be transcribed 
from or to non-continuous areas of core, random access storage, or 
tape. Each function is composed of two operators; one to specify the 
operation to be performed and the second supplies the parameters 
reqtiired to perform the operation. 

. SREAD - scatter read requests the system to transcribe data 
from continuous area of random access storage or a single tape 
block into one or more non-continuous core buffers as specified 
by buffer words in LIST operator. 



SREAD$Alabel of LIST operator 



ENT * B7 


LABEL 


EXRN 


1 2 A 



Packet 



GWRITE - Gather write requests the system to tr€Lnscribe data 
from one or more non-continuous core buffers on to one con- 
tinuous area of random access storage or a tape block as specified 
by the LIST operator. 



GWRITE$2i label of LIST operator 



ENT ^ B7 


LABEL 


EXRN 


10 2 5 



MREAD - multiple read requests the system to transfer data from 
one or more non-continuous areas of random access storage or 
multiple tape blocks into one or more core buffers as described 
by the LIST operator. 

MREAD$Alabel of LIST operator 



Packet 



EXT * B7 


LABEL 


EXRN 


10 2 6 



List Operators 

l/O requests may be generated with remote parameter packets in lieu 
of the in-line packet. In this case the specification list is 
generated by the LIST operator. When this operator is used the l/O 
request specifies the label of the LIST operator. Three LIST oper- 
ators are provided. 
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LIST$ 

The LIST^ operator may be used in the conjunction with the following 
I/O operators J READ$, WRITER, REi"J)L$, WRITER^, BLOCKR$, BLOCKRL§, 
SEARCH^, SEAJn:iiL|, BL0CKS$, BLOCKS^, BLOGKSL$, SEARCHT$, SEARGHEi$, 
SEARGHpI, and SEilRGHPL$. The LIST| operator is as follows: 

LABEL ->LIST$Afile code, # of words, buffer base, logical 
address, search I.D. 

The packet generated is as follows: 

LABEL 



FILE CODE ( # OF WORDS 



BUFFER BASE 



LOGICAL ADDRESS 



SEARCH IDENTIFIER 



Note: If Search I.D. is present, logical 
address must be present • 

Associated with the above LIST$ operatpr, a Read request would 
appear as follows: 

RSM)$^ LABEL 

The generated call would then be: 



ENT ^ B7 


LABEL 


EXRN 


10 1 



LISTA§ 

The LISTA^operator is used in conjunction with the following 
I/O operators: SREAD$, GWRITE$, and MREAD$ on unit devices (i.e. 
magnetic tape and card reader). The LISTA$ operator is shown 
below. 

LABEL -). LISTA$Afile code, # of buffers, logical address, 
# words/base, # words/base, etc. 

# of buffers - the number of buffers described as # words/base in 
this operator. 

Logical address - must be present (zero for magnetic tape and card 
operation 

# of words/base - describe each core buffer relative to programs 
lower lock setting* The number of buffers is not limited. 
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The packet generated is: 



LABEL. -> 



FILE CODE # OF BUFFERS 



LOGICAL ADDRESS 



# OF WORDS 



BUFFER BASE 



# WORDS 



BUFFER BASE 




LISTB$ 

The LISTB$ operator is used only when executing the MREAD$ operator 
on random access storage. The LISTB$ operator is shown below. 

LABEL -^ LISTB$A f ile code, # of buffers, #. words/base/logical 
address, # words/base/locigal address, etc. 

The parameter packet generated is as follows: 



FILE CODE 


# OF BUFFERS 




# WORDS 




BUFFER BASE 


LOGICAL ADDRESS 


# WORDS 




BUFFER BASE 


LOGICAL ADDRESS 


/ 


'^ 
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3.5.3 Status Codes 



The status of each input/output operation is indicated, upon 
completion, in the A-register when control is returned to the 
worker program. Supplementary information may also be contained 
in the "A" and "Q" register. Upon successful completion, the 
"A" register is set positive on normal operations and may contain 
the logical address of a find when a search of random access 
storage was specified. The Q register contains # of words 
transferred . 

All abnormal status conditions are signaled by 2^°"^" of "A" . 
register set to (l) with a six bit in the lower of indicating type 
of condition. Frame count errors on magnetic tape will be in- 
dicated by 2^9 of the A register = and 2 -2^ equal to the 
magnitude of the frame count error. 

. Inappropriate function (01 ) - The function code is not 
applicable to the file (e.g. READ on a printer file or 
SEARGHP oh a tape file). 

. Incorrect Parameter (02) - Buffer outside program lock limits, 
or illegal function code. 

, Unrecoverable Error (03) - The requested function cannot be 
completed. Recovery procedures have been attempted and have 
proved unsuccessful. Parity errors, sequence errors, etc. fall 
in this category. 

. End-of-file (04) - An end-of-file mark has been detected on 
magnetic tape or the end of allocated area has been reached on 
a random file read. 

. End-of-tape (05) - A write operation has been successfully 
completed beyond the tape limit mark, or load point has been 
encountered during a KEADB operation. 

. Unsuccessful Search (06) - The search identifier could not 
be located within the specified area of the file. 

. Illegal character (07) - An illegal combination of punches 

(any combination of holes in rows 1. 2, 3, 4-, 5,-6, 7or9) 
has been detected in a card column (translate mode only;. 
The illegal character will appear as a 00 code in the buffer. 

, No assignment (10) - No assignment mode for the referenced 
file code. 

. Inter3,ock (11) - Operator has indicated that an interlock 
condition cemnot be corrected. 
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4»0 Core Allocation 

Descriptions of available core storage are held in chains utilizing free 
storage described to maintin its links. Normally the only requestors eligible 
to reference core chains are Omega and RT/comm control. 

Three classes of chains are maintained by the system. Chain 1 holds free- 
storage, all non-committed core, arid is used for program allocation, forming 
of other chains and to accomodate dedicated chain overflow. The second class 
are chain numbers two through five and are reserved for exec usage* Chain 
two contains unused storage modules, chain three activity addendums and chains 
3-5 are unassigned. 

The third group of chains are declared by and dedicated to the RT/ coram control 
programj used to allocate core storage for worker programs, buffers or data- 
pass areas. Normally chain declaration is made during the initialization of 
the RT/comm control program committing an optimum area to the function. The 
system, upon dedication, will allocate a continuous area of core to the request. 
Expansion of a particular chain will be performed dynamicly from free storage 
by the system upon senseing or unsatisfied request. All expansions will be 
returned to the general poolupon their release by the user. During peak periods 
of processing the RT/comm program may establish an additional chain at the 
expense of lower prior i1y "programs to accomodate overflow. 

Chain declaration - each chain declared by the user must be assigned a number 
greater than 5 usedto perform all references. The user has the option of 
declaring the committed area into twotypes of chain regulated mainly by 
intended usage. The first is a fixed module chain where each link is a given 
size; providing faster request/release mechanism as well as one less parameter 
at usage time. The second type provides for variable requests a parameter 
supplied at request timej giving the user more flexibility and promoting 
less wastage. 

All allocations , request6s or releases must be made in multibles of 2 words 

FCHAIN$ VO, V1 , V2 ,. • " 

where VO - chain # assigned 5 - N 

V1 - contains # of words declared if variable chain or # of 

words in each module if fixed chain. 
V2 - # of modules if fixed chain if variable chain. 

Packet 



ENT ^ B7 


VO 


■ENT ^ Q 


V1 


ENT ^ A 


• V2 


7 7 3 4 


2 2 


1 4 



Upon return of control A register will contain status of request 2 set 
indicates core not available. 

Chain release - used by RT/comm control to deallocate a previously declared 
chain. Caution must be used not to release chain before all expansions have 
been returned to the general storage pool. 



A-1 



RCHAIl^ VO 

where VO - # assigned to the chain by FCHAIN* operator 

Packet 



ENT ^ B7 



■yo 



773A0|2 021 ^ 



Memory request - from a previously established chain, a given number of words 
or a module in the fixed chain case, 

MEMADD$ VO, VI 

where VO - # assigned to chain by FCHAIN operator 

VI - number of words requested when a variable chain is being 
referenced . 



packet 



Control is returned following packet with address of requested core in the 
"A" register relative to lower lock setting of requestor. If core not available 
in the specified chain or free storage, 229^^of the "A" register will be set. 
"0" register contains § of words or modusles reisaining in the chain. 



ENT ^ 


B7 






VO 








ENT ^ 
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Kemory release - requestes the release of described core storage to the indicated 

chain* 

MEMREL$ VO, VI, V2 

where VO - # assigned to chain 

V1 - base address of core relative to lower lock of submitter 

V2 - number of words being released applicable only to variable chains 

Packet 
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Core Chains - are linked from the task addendum of the. user to accomodate 
multible RT/comm programs. For each declared chain the following description 
is formed to control usage. 



wora 



Chain # 



{'Type of chain 



Link to next descriptor 



Current #of links Size of link 



Base of core assignment 



End of core assignment 



Chain address 



Pointer from addendum 
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Word - contains chain niimber assigned by FCHAIN operator and type of 
chain - indicates variable, 1 - indicates fixed. 

Word 1 - link to next chain descriptor o-o indicates end. 

Word 2 - contains number of modules free vhen chain is fixed. This value 
is returned to the user (in Q register) upon each request, 
thereby, providing a mechanism tosense depletion for time 
critical usage. Sise of link is used for fixed chains when 
retriving a module from free storage to accomodate overflow. 
If chain is variable, word 2 contains number of words currently 
available and is returned in Q register for each request. 

Word 3-4 describes the core area committed to the chain. 

Word 5 - address of first link in chain.- 



Chain links - each link in a chain describes its area and points the next link. 



Word 
1 



Address of next link 



# of words 



Word - is a 17 bit address relative to base of machine of next link in 
chain. 

Word 1 - applicable to variable chains only and contains # of words in link, 
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5,0 Task Control Functions 

Sntiyj Miscellaneous functions are entered from a table at label 
MISC. A jump is performed using the lower four bits of 
the EXEC call to determine the requested function. Illegal 
parameters are referred to a common error routine. 
Miscellaneous functions currently available for use as 
follows: 

• ■ PUSH 

A storage module has been formed and linked to current 
activity by EXRN routine. The PUSH mnemonic requests 
current activity to be linked to chain specified by V0 
by priority in ascending order. No control is returned 
until a complementary POP is given. This function is 
normally used by l/O control, content supervisor, etc. to 
queue and inactivate activity until requested seinrice can 
be performed. 

PUSH$AVj2f 
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VJhsrs V0 is the base core address in absolute of linking 
cell of chain on which current activity is to be linked. 

Queue activity reference - mechanism for linking requests 
to activities previously defined by REGQ. A storage module 
is formed by this request and the parameters in registers 
A, Q, B1-B6 at the time of reference are stored in the SMOD 
for activation at execution. If this is the first QREF 
associated with the registered activity the activity is ' 
placed on the queue. If not the first it is linked to 
activity addendum for later execution of the registered 
activity. In any case, control is returned to the requestor. 

QREF$AV0 
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Where V0 is the binary identity of the activity referenced 
by the QREF$. Used to perform a search on available activities 
within the task and identify the necessary activity addendum. 
Binary identity that is specified must not be ^ (vp 4- 0) • 
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RETURN 

This entry is used to relinquish control to the executive 
at the conclusion of an asynchronous activity or task. The 
routine checks if referenced activity is task-permanent 
(i.e. it has binary identity) , If it is task permanent, the 
SMOD just completed is deallocated and removed from chain 
associated with this activity. If there are any other 
SMODs linked to this activity they are given control. This 
activity addendum is not deallocated until conclusion of 
the task. 

If this is not a task-permanent activity, it is checked 
to see if it is a fork from some other activity. If so, 
the activity just completed is deallocated and control given 
to forking activity providing a join has been given and that 
activity has no other outstanding forks. 

If this is not fork from another activity, it is possible 
that the requestor may have no outstanding business which 
would cause reactivation j(with the exception of queued 
activity registration) , then the associated task is checked. 
If there exist no outstanding processable activities, forks, 
incomplete hardware level I/O requests or latent time of 
day restart requests, the task is terminated. Subsequent to 
task termination, facilities are deallocated and the next 
job task is sequenced or the job is terminated if no tasks 
remain. Otherwise, control is switched to some other task/ 
activity active in the multi-program environment. No parameters 
are required for RETURN operator, 

return! 
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FORMATOR 

This is entered by a jump to ASCAN1 , This routine receives 
command words through the storage module from the requestor 
and formats a channel executor module which is then queued 
to the appropriate GCB for subsequent execution of the 
input-output commands, . 

EXRN I <^ e( gf gl 6" 
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•DELAY 

The Delay function is a way that task and task fragmehts 
can have themselves reactivated after a specified milli- 
second delay. The millisecond delay counter may be from 
1 millisecond to a maximum dealy of 24, hours. If the 
millisecond delay counter is over 5 minutes the time 
delay will be established as a time to activate and will 
be placed on the day clock timer routine and activation 
will be done on the gross timer of the day clock with 
a plus or minus variation of 6 seconds. If the delay is 
under 5 minutes it will be established on the real time 
clock queue with a plus or minus variation of 200 micro- 
seconds. The millisecond delay counter will be held in 
the Q register at the time of the Exec return. 



delay! 



ENT.Q.V0 
EXRN. 00007 



where V0 is the millisecond delay counter and may 
be in the form of W(X) . 

It should be noted that the delaying routine will only 
be placed on the C.P, upon completion of the delay time. 
Subsequent control could be further delayed to process 
higher priority activities . 

Control will be returned to the instruction immediately 
following the EXEC RETURN with all registers restored with 
the exception of Q. Q will contain the difference between 
the actual time the routine wanted control and the time 
the switch to the routine was performed* 
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5.1 Fragmentation Requests 

Definition: A fragmentation request (activity registration, fork 
or join) establishes an independently executable 
program. The request implicitly requires allocation 
of additional core to serve as the addendum necessary 
to execute the requested fragment o Once established, 
an activity or fork may make the same service requests 
as a task and will share with the task operational 
identity, primary cooperative streams, facility 
allocation, logging and accounting* 

• Standard Activity Registration defines a re-entrant 
activity to be registered with G.P. control for 
execution. The values of A, Q, B1-B7 are set to that 
of the requestor with B7 containing the address of 
the packet. Parameters specify the location, relative 
priority, data area, and relative index to be associated 
with the activity. After queueing control is returned 
to registering activity. The activity is initiated 
with 'all operational registers set to that of requestor 
in 15 -bit mode. 

REG^Ayo, V1, V2, V3, V4., V5, V6 
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Y0 - Address of activity in memory; this is implicit 
starting point of activity. If independently 
compiled program (V4.=0) this address must be a 
multiple of 100, 

V1 - 15-bit address of data area in core. 

V2 - 15-bit length of data area. 

V3 - Data area mode 

J^-indicates read/write lockin will be set to the 
data area defined by Y1 and V2 and ree^d will be 
permitted from any area. 

1 -indicates use of read/write lock of requestor. 
The only means of reaching the data area is through 
use of registers B4-B7. 

V4. - Activity mode indicator; zero specifies the activity 

is an entity and contains all referenced data exclusive 
of the declared data area and was independently 
compiled so that the first instruction is relative 
to address zero. Non-zero mode indicates that the 
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activity is integral to the requesto and RIR is 
not adjusted address of activity. 

V5 - relative response priority (0-17) may be declared to 
attain a differentiation with respect to other 
activities currently operated within the task. When 
priority is not specified, the priority of the 
requestor is assumed. 



V6 ■= i 



use priority of previous, none specified 



1 - priority has been specified 

Queue Processing Activity - a means of utilizing a task 
permanent activity to respond to a series of events. 
Transactions are accepted and queued by the system and the 
activity is executed whenever a queue entry exists. The 
activity signals completion for a given transaction by 
return of control via return operator. Omega re-executes 
the activity if any other SMODs remain linked, to queued 
activity for execution. 

After registration via a REGQ operator the activity becomes 
task permanent and can be referenced by a QREF any time 
before termination of the task. Use of this function allows 
the scheduling of events at occurrence. It is appropriate 
where no advantage can be gained from registration of 
concurrent executions by re-entrant code. Two operators 
are associated with use of this function, REGQ and QREF. 
The first defines the activity and the second supplies the 
data to the registers to be queued. 

REGQ$AV0, V1, V2, V3, VA 
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- 15-bit address and starting point of activity. 

- 15-bit length of activity, zero implies read/write 
lock will remain set to that of requesting activity 
and the activity is considered an integral part of the 
compiler requesting activity. Non-zer6 length defines 
the area to be protected by memory lock-in and RIR 

is set to Vjzf. 



V2 - Binary Identity of routine for further reference via" 
the QREF operator. V0 = ■ 

V3 - Same as V5 for standard activity. " (priority) 
V4 - Same as V6 f or standard activity. 
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Fork - represents a method 'Of activity registration in 
which the executive will correlate all forks from a given level 
so that completion of the synchronous activities from any 
level can be tested through the use of the JOIN function. 
All FORK activities are considered integral to the requestor • 
and atain the same RIR and lock-in- values of the requestor. 
At time of activation, forked activity will contain operational 
registers of requestor, 

FORK$AVZi 
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Y^ - 15-bit starting address of activity. 

The FORK operator is more applicable to general batch 
processing programs than real time transaction processing 
since it provides a higher level interface and synchronization 
is on a gross basis. The only parameter required is a start 
address. An activity established by a fork may, in turn, 
establish other forks which provide additional levels of 
controlling parallel paths. 
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A JOIN entry requests a wait until all asynchronous 
activities previously established by FORK have been 
completed as indicated by relinquish operator RETURN. 
The JOIN mnemonic sets a join bit in the activity addendum 
that remains set until the last forked activity from 
that activity has given the RETURN. Then the fork count, 
goes to zero and control is returned to the original 
activity. A JOIN given in the task itself will wait on 
all forks outstanding within the task since the task is 
the base of all forking, A join from an activity will 
wait not only on those forks directly established by the . 
activity, but also those forks set up by forks that are 
themselves direct forks from the requestor,. No parameters 
are required for ' this operator . 



JOIN$ 
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The restricted task control functions are those used by the 
OMEGA system and are not available to the general user. 



i Register Control Thread 

This function allows any part of the OMEGA system to establish 
a path starting at any of the primary OMEGA functions that 
acts in the same manner as a normal OMEGA call to the primary 
routine. Parameters needed are a 15 bit value to be stored 
in IFR lower to act as the OMEGA call and a JOB number of 'the 
task addendum to which the formed activity addendum must be 
linked. IFR value will be in register B1 and JOB number B2, 

EXEC RETURN format is 

EXRN. 00020 

The task control routine upon receipt of this function will 

form an activity addendum and a storage module with the value 

in B1 stored in IFR lower. This storage module will be the 

one the primary routine will process. One additional storage 

module will . be formed to activate control at the primary OMEGA 

level. Next the task addendum whose JOB number matches with 

the value of B2 will be found and the activity addendum will be 

linked to it. Then the activity will be queued oh the C.P. queue 
and control returned to the requestor. 

• Abort Control Thread 

This function allows any part of the OMEGA system to have 
removed from control the activity addendum it is presently 
running under . The activity addendum and all storage modules ■ 
are placed back in the free core chain. No return control is 
allowed and no parameters are needed, 

EXEC RETURN format is 

EXRN' 00021 

• Special QREF 

The special QREF is the same mechanism as the normal QREF 
with the exception that JOB number is also supplied. The 
correct task addendum will be found before the normal QREF 
is performed. Register B7 contains an address of a one word 
packet of information. 

Packet format is 
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6.0 Secondary Exec Functions 

Secondary Exec Elements are those required to load, activate, 
and terminate tasks introduced into the system via the I/O . 
cooperative mechanism. Due to low usage of these functions in 
relation to the total system, the majority of routines are 
based on random access storage and loaded into core when the 
need arises. 

The content supervisor is a resident exec routine responsible 
for loading and/or activation of drum based secondary EXEC 
functions used in performing service requests. Lib # of 
EXEC return instruction specifies service routine to activate 
and indicates if the service routine is re-entrant, allowing 
multiple simultaneous usage of routine, or non re-entrant requiring 
the content supervisor to control usage of the routine. 

Each secondary Exec service routine is limited' to 2,000g words 
in length including segmentation and buffering. Dependent upon 
core storage available and usage of routine, a copy of the 
service routine will be allowed to remain in core after completing 
a request and will be utilized to perform subsequent requests. 

The following is a list of service routines which operate under 
control of the content supervisor and the service requests which 
activate them. 

. Content Supervisor , library number 000. The following functions 
are processed directly by content supervisor, upon activation by 
a Direct Return (DRET1$) from a secondary exec routine or on 
exec return in the case of the Purge request. 

* Function Code Operator Description 

00 B1=0 Internal Release routine in IFR and return 

control to next storage module in 
string. 

00 B1=1 Internal Release routine in IFR and call 

routine listed in B2, BJ+ is set to 
original value of storage module 
causing activation. 

00 B1=2 Internal Release routine IFR.. Deallocate 

the control thread of the current 
activity and release control to 
the exec. 

01 Internal Purge the highest order secondary 

exec routine in core, but not currently active, 

02 Internal Purge all inactive secondary exec routines 

currently in core. 
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•iioaa ana modiiy to r^mning iprm tne indicated 
element into the assigned core. B7 equals the 
absolute value of the following packet. 



FC 


LENGTH 


# SEG . 


GORE BASE 


FILE- 


INCREMENT 



FG - The file within which the element may be found i 

LENGTH - The length of the elements control portion 
or the maximum core used. ■ ' 

CORE BASE - The absolute address at which the element 
is to be loaded . 

# SEG - The number of segments contained ■ within 
the element. (229 ^ 2^^) • 

FILE INC. - The increment relative to the base of 

the file containing the element at which 
the instruction of the control part start. 



Functions 01, 02,' 03 are requested by an EXHN*2000X, Control is returned 
immediately following the EXRN instruction. 
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LiDrary 

Number 

001 • 



002 



003 



004 



005 



006 



010 

011 
012 

013 



OU 



015 



Name 
Service Functions 1 

Service Functions 2 
l/O Error Recovery 
Console Control 



Facility and storage 
assignment 



Service Functions 3 



uooperat/ive oervice 
Routine 



Pre-Selection 



Selection 



Termination 



Remote facility 



Library Service 
Routine 



Checkpoint and 
Restart 



Description 

Re-entrant routine responsible for, 
high priority service requests. 

Re-entrant routine responsible for 
processing high priority service 
requests . 

Re-entrant routine responsible for 
input/output error Recover for tape 
hardware handlers." 

Non re-entrant routine used to 
analyze and switch console operator 
messages. 

Non re-entrant routine to process 
Assign and Release requests for 
mass storage and peripheral devices. 

Non re-entrant routine to process 
search or form type requests. 

Non re-entrant routine to process 
service requests in the control ■ 
of Unit record routines and l/O 
Cooperative Control, 

Non re-entrant routine used to 
summarize scheduling data for 
task' a'^tivit'^'" • 

Non re-entrant routine used to 
select and initiate task/activity. 

Non re-entrant routine to deallocate 
and close task/activity routines 
and/or control threads. 

Non re-entrant routine responsible 
for the assignment of remote 
communication devices and the load 
and activation of required remotes. 

Non re-entrant routine responsible 
for transferring elements produced 
by generators, compilers, assemblers, 
and loaders to the job library. 

Un-defined 
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Library 

Name 

016 



.017 
020 
021- 
022 



Name 



Compaction 



IHimp 



023 



l/O Error Recovery 2 



l/O Error Recovery 3 
Phase 1 Rexecutor 

Phase 2 Rexecutor . 



Description 

Responsible for compaction 
and purge of core and/or 
drum storage. 



Mass storage 

Unit record peripherals 

•Load REX oriented batch 
programs. 

Execute REX oriented batch 
programs* 
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Content supervisor is activated upon an exec or worker 
task/activity executing an EXEC return instruction with two (2) 
exec call in bits positions 12-H. Upon activation B4 contains 
the address of storage module cuasing activation and performs 
the following functions. 

. Unstring Library number, bit position 5-1 1» and function code, 
bit positions O--^, contained in IFE of storage module. 
Library number and. function code are entered into B registers 
1 and 2 respectively. 

. Validates library number and determines if. service request • 
is to be processed by core supervisor or drum based service 
routine, 

e Content supervisor has two type of requests which are directed 
to.it for processing: one to purge all routines not currently 
■ active, the other is- the mechanism for returning control to 

the content supervisor by a secondary, exec function and is 
. performed- by the following packet: ' . 



ENT^^-Q^- 



TT.WTv.a^- 



7 7 3 4 



2 Switch function code 

12 I S of routine to switch to 

d 



When this packet is utilized, no storage module is allocated 
and control is returned to content supervisor. Upon receiving 
control C.S, will release secondary exec routine listed in IFR 
of previous storage module and then analyze B1 for subsequent 
action. 

B1 = O) Control will be returned to previous storage module 

B1 = l)Use B2 as the function code and Lib # of another 
secondary exec activity to schedule and run under 
previous storage module. B2 will be plugged into IFR. 

B1 = 2) Release the routine in IFR of current storage 

module, deallocate the control thread of the current 
activity and release control to the pxec. 

Calls for drum based secondary exec functions to satisfy serviae 
requests are handled as follows: (See accompanying block 
chart and table) . 

The called routine is located in the table and disposed by 
either queueing request for later activation or activating 
the called for routine. The content supervisor, upon activation 
of secondary exec functions, sets RIR to address of instructions, 
IFR' to 17 bit B registers PLR to all of core and operational 
registers as follows. 
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B1 Library number of called service routine 

B2 Function Code 

B3 

B4. Address of storage module causing activation 
biased by lower lock limit 

B5 The address of the core facility and storage summary 
biased by lower lock limit 

B6 

B7 

KSSRIR - Increraent within the storage module addressed 
by B4., contains the RIR of the secondary exec 
routine given control 

, The content supervisor allocates core for service routines 
in modules of 100g words up to a maximum size of 2,0003. Gore 
storage is obtained from the general pool unless exhausted 
in which case one of the inactive service routines will be 
purged to obtain the core. Normally once a service routine 
is loaded it will remain in core until the storage is required, 
Inactive routines of a higher library number purged first. 

Secondary exec service routines are general non re=entrant 
code having full capabilities of segmentation and making 
additional service requests, l/O access as a normal activity. 
Their only constraints are as follows: size is limited to 
2,0003; starting address is implicitly defined as their 
first location; they are self -initializing and have a special 
termination to the core supervisor. Each service request will 
be processed under task/activity performing request. 

Content supervisor maintains the following list called "ETAB1 " of 
routines operating under its control. Each entry in the list 
is ordered by Lib # and contains the following values. 



Word 
1 
2 



Current # of users I Lib # of routine 



ZE 'Length of routine 



IRIR of routine 



3 ' Drum Increment to routine 



4, I {Queue Cell 



Word contains library number of routine; and current number of 
users, zero indicates routine is, eligible for purge if 
core required. 

Word 1 ZE is the file code of systems library used in drum call; 
length is the maximum size of routine.. 

Word 2' contains address of routine relative to base of machine and 
- will be used as RIR setting during switch cycle and indicator 
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that routine is in core; zero indicates routine not 
in core. 

Word 3 Contains drum increment of routine in systems library. 

Word 4 Contains Queue cell to chain calls for routines currently 
active. 
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Control Transfer- Functions Used In Secondary EXEC 
1, Direct Return (DEETiS) 



ENT*Q*2 


ENT*A*12 


EXRN *jZf 



Where used - All secondary EXEC routines 

1/Jhen Used - When all responsibilities of routine have 
been completed. 

Function - Will cause IFR and registers in LGR module to 

change and a transfer* of control to the content 
supervisor via LGR. No storage module deallo- 
cation occurs. 



Additional 
Parameters 



1A:B^ = Release routine in IFR of current 
storage module and return control 
to next storage module in string. 

IBiBi = 1 Release routine in IFR call routine 
whose library number and function 
code appear in B2. 

1G:B-j = 2 Release routine in IFR of current 
storage module, deallocate the 
control thread of the current 
activity and release control to 



2. Register Control Thread 



ENT*B1*EXEG GALL 



ENT--^B2^J0B # 



EXRN^REGCT 



Where used - (Console handler, request for contsole control 
routine), (l/O cooperative, request for GSR). 
(RETQRi^, request for termination). 

When used - VJhen it is necessary to establish a control thread 
under another task addendum. 

Function ■ - Set up an activity addendum, LGR, and a storage 
module under the specified task, addendum. Bi is 

placed in; IFR or LGR and storage module. Transfer 
control to routine in LGR, IFR location. 
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3, Switch Control Thread 



ENT^-A^^JOB # §c SwC 



MT^Q^ACT. ADDM. ADDR. 



EXEN*j2J 



Where used - (CSH, from SIEC worker addendijim before switch to 
pre-selection) J (Pre-selection, worker to EZEG 
before switch to selection), (Selection, EXEC to 
worker before switch to initiation), (Termination, 
worker to EXEC before switch to selection). 

When used - When it is necessary to switch from one addendum 
to another addendum. 

Function - Remove the control thread for the current activity 
from its task addendum and link it to the indicated 
addendum. 

4.. Abort Control Thread 



KSM*0002^ 



Where used - In Content Supervisor upon request of a secondary 
EXEC routine entry via DRET$ with B-j = 2. 
(Selective when no task can be selected.) 

When used - When no further processing is possible and no 
point for return of control exists. 

Function - Remove and discard the control thread from the 

current activity the release control to the dis- 
pather. 

.5. Direct Switch 1 (DSW1$) 



ENT*Q*ADDR 


ri'r 


ENT*A*00010 


EXRN^OOOOO 



Vfnere used - Content Supervisor 

When used - Iton. a secondary EXEC routine is given control after 
its availability is determined. 

Function - Reset RIR and drum increment and transfer to 
addrjpss satisfied. 
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6, Direct Eetum 2 (DBET2$) 



ENT^A*13 



EXRN*00000 



"Where used - Content Supervisor 

When used - Upon a D3ET1$ from a secondary EXEC routine' 

implying a return of control to the requestor. 

Function -. Deallocate last storage module on current 
activity auad return control to it. 
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6.1 .3 Secondary Exec Chain List 

Within the Secondary Exec it is often necessary to utilize the 
services of other Secondary Exec roiitines. If this is done via 
a EXRN^20XXX, the requesting routine will be locked out if it is 
not reentrant. Even if it is reentrant it will be required to 
remain in core at the same location until the requested service 
has been completed. When it is considered that the second level 
request may in turn cause requests to other routines it may result 
in a pyramid of routines necessary in core at- one time to process ' 
a single request . 

lb alleviate this problem a chaining procedure is herein defined 
which allows a secondary exec routine to obtain the services of , 
other secondary exec routines during which time it is released 
and may be used for another request or purged if the core is 

required. 

It is necessary that any routine initiating a chain request be 
coded such that it may be purged and unloaded at a different 
location between the time that it makes a chained request and when 
it gets control returned from that request. 

It is the responsibility of the routine initiating a ohainsd 
request to obtain free core for the list and to set the list 
initially. 

The content supervisor will update the list upon the entrance 
to and exit from the routines involved in the request. 

When the initiating routine gets control back from the request 
the chain list will contain a list of all routines involved in 
the processing of the request and the status returned by each, 
along with a combined status which consists of the logical 
sum of all the returned status ' s , 
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'The requirements for the initiation of a chained request within 
the Secondary Exec are listed below. 

1) Obtain free core sufficient to contain the list and all 
entries possible, 

2) ' Set up the first 6 words of the list as shown in figure 1 . 

3) Set the sign bit in the IFR location of the current storage 
module and save the address of the list in KSOL of the 
storage module, 

'The requirement of the initiator upon the completion of the request 
are as follows. 

l) Release free core used by the list. 

>The Content Supervisor will, check for a chained request upon entrance 
from a Secondary Exec routine. If it is a chained request one of the 
following procedures determined by the type of exit from the Secondary 
Exec routine will be taken. 

1) B1=0 a) Set the logical status and the individual status 

in the chain list^ for the process just completed, 

u) uiear the sign bit in tne ixit luua uxuii ux oaa 

SMOD 

c) Give control to the initiator using the return 
library number and function code (IFR) in the 
chain list . 

2) B1=1 a) Perform status set as when B1=0, 

b) Store call for routine 'in B2 in the chain list, 

c) ►Process request for routine defined by B2. 

3) B1=2 a) Set abort status in logical status word of. the 

chain list, 

b) Process as if B1=0 
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'The following is a coded routine which will form a chain list and 
do the initialization. The functions performed by this routine would 
be required for the initiation of a chained request. 



FCLST 



Form Chain List 

Input - B4 = address of current SMOD 
B1 = size of list required 
B3 = return IFR setting desired. 

Output- B7 = absolute base address of list 
KSCL = address contained in B7 
IFR = sign. bit will be set in the lower. 

Entrance EBJP«B6'FCLIST 

Exit JP«B6 

Registers Used Other Than Input/Output = A, Q 



FCLST 



FCLSTA 



CL^B7 • 

ENT^Q^BI 

EXRN-x-MMADD$ 

JP-;^FGLST4^ANEG 

ENT^tB7*A 

STR^B1^U(B7) 

PUT^6*U(B7) 

ENT^A^LX(KSIFR+B4) MEG 

SEL^SET^ 4.0000 

STR^A^L (KSIFR+B4) APOS 

ENT^Qi^^W(KSCL+B4,) 

CL-'^Q 

STR^^Q^^W(B7+4) 

OfTTD.v.nr»itT.T^vcnT < -n i \ 

STR^B3^U(B7+$) 

CL^L(B7+5) 

JP^B6 

EXRN^^PURGEAl 

JP^FCLST 



Free core chain 

# words to request 
Request core 
Didn't cut core 
Address of list 
List length 

# words used 

Currently in chained request 

No set sign bit 

Restore, nested request 

Pick up nested chain addr 

Clear nest link 

Set nest link ■ 

Set chain addr. 

Return IFR 

Clear logical sum status 

Exit 

Purge unused routines 

Try again 
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SECONDARY EXEC CHAIN LIST 






LIST LENGTH 


# WORDS USED 


1 


ORIGINATOR 


2 


• STORAGE 


3 




AREA 




U 




ADDR 


PREVIOUS LIST 


5 


RETURN IFR 


COMBINED STATUS 


6 


REQUEST IFR 


STATUS 


7 


REQUEST IFR 


STATUS 


• 
• 

N ■ 

■ 






-^-^ 



Word 



U - The length of the list as determined by the 
originator . 

L - The number of words used in the list at the 
present time. This servies as in increment 
to the first free word in the list. 



1-3 



Storage area for use by the original requestor. 

The address of a previous list in case the current 
list is a chain list originating within a chained 
request. Word U of the initial list will be 0. 



U - The IFR setting necessary to return control to 

the originator . 
L = The coiTibined status of all requests within 

the chain. 

U - The IFR for the initial request made by the 

originator, 
L - The status of the request. 

U - the IFR of a request made by the routine 

requested by the originator*, or some other level 
. routine . 
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QfnntJArLT? yrn-nr-rTU' T?n-D op AT-Nrt^-n c-cv-ifj^j-piA-Dy TrYTrn ipxpriTTC'qfp 



10 

11 

12 
13 
U 
15 
16 
17 



IPUSH POP LINK 



ACT. ADDM. ADDR. 



IFR 



RIR 



LOCK LIMITS 



A 



B1 



B2 



11 



M. 



Bl 



B6 



B7 



SECONDARY EXEC ROUTINE RIR 



ADDR CHAIN CELL 



KSIFR 



KSCL 



Figure 2 



The routine vhich initiates a chained request would set the sign 
bit in the lower of the IFR (Word 2) in the storage module. This 
would signal the content supervisor to update the chain list upon 
exit from a servicing routine. 

If the sign bit in the lower of Word 2 is set, word 17 (KSCL) is 
assigned to be the chain link. Therefore, if the request is 
chained the KSCL location should not be destroyed in processing. 
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6,2 Service Functions (1) Library number 001 is a re-entrant service 
routine responsible for the following service requests. 



Description 

Load indicated segment 

Load and activate indicated segment 

Unstring specified statement 

Convert specified numeric 



Function 




Code 


Operator 


or 


LOAD$ 


02 


LOADA$ 


03 


UST$ 


OA 


CVT§ 


05-37. 


_Unassigned_ 
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Service Functions (l) Library number 001 is a re-entrant service routine 
responsible for the following service requests. 

•LOAD A SSGMMT (Function code 01 ) 

This request will load a segment into core from random access storage. 
This is an unconditional load directive, i.e., the segment will be loaded 
regardless of whether it is still resident in core from a previous load 
operation or not. The LOAD^ operator is the direct method for having a" 
program loaded into core. The indirect method is to jump or return jump 
to some extemallj defined label within the segment. If the -segment is 
still resident in core, it will not be reloaded; thus a segment should be 
self -initializing if the indirect method of loading is used. If the segment 
is not in core, it will be loaded from random access storage and the jump or 
return jump performed. 

This request will load the segment that contains the externally defined label 
reference found in the lov:er 15 bits of 37.' 

Operator: LPAD§<iLABEL 



•Packet: 



ENT*B7 


T.ABKF, 


775^0 


20041 



*LOAD A SEGMENT AND ACTIVATE (Function, code 02} 

This request is similar to the L0AD$ operator. The segment containing the 
externally defined label found in the lower 15 bits of B7 will be loaded into 
core from random access storage. This is a unconditional load: the segment 
will be loaded regardless of whether the segment is resident in core- from a 
previous load or not. After loading, control will be passed to the referenced 
label, i.e., a JP'^LABSL instruction will be performed. 

Operator: LOADA^^LABEL 



Packet: 



ENT^B7 


^ LABEL. 


77540 


20042 



•FISLDATA TO BINAEI GONVEP^ION (Function code 04) 

This request will convert a number from fieldata to binary. The fieldata 
number can either be octal or decimal. It must be positive. The largest 
octal number that can be handled is 7777777777; the largest possible decimal 
namber is 536S70911 (2^° - l). "The fieldata number must be an integer. The 
resultant binary number will be positive and single precision (contained in 
one word). The fieldata number can be contained in one or more words of 
core. There can be leading and trailing fieldata spaces (05) or binary 
zeroes (OO), While only leading spaces or zeroes m'll be allowed between 
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the left-hand end of the field and the most significant digit, the 
conversion routine will ignore anything following the first trailing 
fieldata space or binary zero. The core address of the left-hand end 
end of the fieldata number field will be in lower 1 5 bits of B7« The 
A register will contain the number of words in the field. The following 
convention will be used to deteimne whether the fieldata number is octal 
or. decimal. The first digit of an octal field will be a fieldata (60); 
the first digit of a decimal field will be non-zero (61-71 ), If the 
conversion is successful, the binary number wiOJ. be placed in the Q 
register and the A register set to 0, If an error is detected, the 
Q register will be set to and a flag bit set in the A register. 



A REGISTSE ELAG 



MSMING 



1 (2^ bit) 

2 (2*^ bit) 
k (2^ bit) 

8 (2^ bit) 

16 (2^ bit) 

32 (2^ bit) 



Non-octal character (character other than 60-67) 

found in octal field. 

Octal number greater than 7777777777 

Non-decimal character (character other than 
60-71) found in decimal field. 

Decimal number greater than 53687091 1 

No number found in field (field consists 
entirely of fieldata spaces or binary zeroes). 

Number of words in field = 0, 



Operator: CVT$iV0,V1 



where VO = the address of left-hand end of fieldata fieldj and 
VI = size of fieldata field 



Packet: 



SNT-i^B7 


LABEL ■ 


ENT^A 


SIZE 


77540 


20044 
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Function Code 03 - 

Caller: 
Parameters: 



Unstring the control infoimation specified and form 
an unstmng list of the fields and the controls 
separating the fields. 

Internal call from operating program via UST operator. 

B4 = Address of storage module causing activation 
biased by lower lock limit. 






TTO-^ 



mA\, v^, V ^ 



V-j = Base address of the control information relative 
to lower lock of the requestor. 

V-] = Base address of the deposit area to 'oa used for 
the unstr-j^ig information relative to lower lock 
of the requestor. 

V^ = Length of the deposit area. If control information 
specified is a continuation of previous infoimation, 
the sign bit should" be set. 

Vo = Length of the pick up area to signal the end of the 
information when no termiiiating control is present. 
If Vo = data is unstrung until a tenninating 
control is found. If V^ is negative (the sign bit 
set), interim spaces are to-., be left in. , 



Packet: 



MT"'B6 


vo 


ENT-^-B7 


V1 


JENT^A 


V2 


MT-^Q 


V3 


EXM 


00003 



Addendum: Worker task/activity addendum 

Function: . Unstring the control information in the following format! 



FIELD 1 DSSC 
FIELD 2 DESC 
FIELD 3 DESC" 
FIELD 4 DESC 
ETC. 



OPTIONS 


IN MSTER BIT FORM 


29^^2423^ words'*-^ 


^IND TO FIELD^ 












FIELD 1 
! 


1 FIELD 2 


FIELD 3 


\ FIELD .4 


! 
1 


ETC. 





TC = terminating 
character for 
field. 

# wjrds = number oJ 
words in field. 

Ind to field = 
index to field 
from base of 
unstrung area. 
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Exits: . Return to requestor; 



"A" Register = 00000 00000 normal completion 

"A" Register = 4OOOO 00000 overflow of deposit area 

"A" Register = 4-0000 00001 deposit area not within lock 

limits'. 
»A» Register = AOOOO 00002 invalid option 
»Q" Register = number of fields if normal completion 

Return. control to content supervisor • 
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6.3 Service Functions (2 ) Library number 002 is a re-entrant service 
routine responsible for ihe following service requests. 



Function Code Operator 



01 . 


TI^K1)§ 


02. 


TIM'Fir.^' 


03 


DATI14$ 


0^ 


XOFF$ 


05 


XON$ 


06 


ZTEST$ 


07, 


tsstfofO 


10 


TESTiJ'UFS 


11 


TSSTi?'L§ 


12 


ERRADD$ 


13 


FQFADD$ 


U 


FUFADD$ 


15 


OPADD§ 


16 


TFC§ 


17 


TOORE$ 


20 


SET15$ 


21 


SET17$ 



Description 

Supply edited time of day 

Supply elapsed time for task 

Supply current date and time 

Set logical switches off 

Set logical switches on 

Supply current logical switch settings 

Floating . point overflow test 

Floating point underflow test 

Test floating point over/under flow 

Establish error address 

Establish floating point overflow address 

Establish floating point underflow address 

Establish illegal operation address 

Test file code for type of device 

Supply Core limits of task 

Set "B" registers to 1 5 bit mode 

Set "B" register to 17 bit mode 
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Service Functions (2) Library niimber 002 is a rs-sntrant routine 
responsible for the following ' requests'. 

•TIME OF DAI (Function code 01) 

This request will return the time of day at the time of the 
request. Hour, minute and second will be supplied. Hour and minute 
will be returned in the A register in the following format: HH : MM* 
The seconds will be returned in. the Q register in the following 
format: 00SB> Hour, minute, second and the colon (:).will all be 
binary zeros. All time will be decimal. 



Operator: 
Packet: 



•TIMEDl 



775A0I20101 



•ELAPSED TIME (Function code 02) 

This request will return the elapsed time for the task in the 
Q register. The time* will be in binary and in units of 200 milli- 
seconds. 



Operator: 
Packet 



TIMELl 
I 7 7 5 A Q 1 2 n 1 2! 



•CURRENT DATE. AND TIME (Function code 03) 

This request will return the year and the day in the A register, 
in fieldata, in the following format: YIDDD, where YI is the year 
and DDD is the day (from 001 to 3^5) . The Q register will contain 
the time of day in units of 200 milliseconds. The Q register will . 
be in binary. 



Operator: 
Packet: 



DATIM$ 
l775/i0 12 0103 



•SET LOGICAL SWITCHES OFF (Function code 04) 

This request will set the logical switches indicated in the Q 
register to (off) . The Q register will contain the names of the 
logical switches (A-E) , in any order, in fieldata, that are to be 
turned off (set to 0) . .- 



Operator: 
Packet: 



XOFFi switches 



ENT.-;-Q^W($+l)^SKIP 



fieldata switches 



775ii0l20104 
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•SET LOGICAL SWITCHES ON (Function cods 05) 

This request will set the logical switches indicated in the 
Q register to 1 (on). The Q register will contain the names of 
the logical switches (from A-E) , in any drder, in. fieldata, that 
are to be turned on (set to 1) 

Operator: XON$ switches ■ 

Packets 






fieldata switches . 
7 7 5 A Ol 2 1 5 



•SUPPLY CURHENT LOGICAL SWITCHES (Function code 06) 

This request will supply the current logica!Wswitch settings 
in bits 25-29 of, the A. register as follows.: ' 

A Register Logical Switch . 

29 A '■ : 

28 B 

27 C 

26 D 

25 E 

If the bit for a particular switch is 1 , the switch was on; 
if it is 0, the switch was off. As an example, if switches B, D 
and E are on and switches A and C are off, bits 25-29 of the A 
register will be as follows: , 01011, where bit 29 is the left 
hand bit. Bits 0-24 will be cleared to 0. 

Operator: XTEST| 



Packet: I77540l20106 



•FLOATING POINT OVERFLOW TEST (Function code 07) 

This request tests the floating point overflow switch. If 
it is off, the A register is set to 0. If it is on, the switch 
is turned off and the A register is set to 1 . 

Operator: TESTFOF$ 



Packet: J775A0l2 0110 



•FLOATING POINT UNDERFLOW (Function code 10) 

This request tests the floating point underflow switch. If it is 
off, the A register is set to 0. If it is on, the switch is turned 
off and the A register is set to 1, 
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uperaLor; 
Packet: 



TiLSTJ^'UI?"^ 



|775A0}201 1 Ol 



•TEST FOR FLOATING POINT ERROR (Function code 11) 

This request essentially combines the tests for floating point 
overflow and floating point .underflow. The switches will be tested 
in the following order: 






j-j-osijing pom Li o"V6rj.low| ij.oa'&mg point 
underflow. If neither the floating point overflow nor underflow 
switch is set, the A register is set to 0. If the floating point 
overflow switch is set, the floating point overflow and underflow 
switches are turned off (floating point underflow switch is turned 
oiTi . automatically in the event that one of the two switches was 
set from a previous floating point error condition that was not 
tested; if the floating point underflow, switch was not on, nothing 
.is, in effect, done) and the A register is set to 1. If the 
overflow switch is off and the underflow switch on, the underflow 
switch is turned off and the' A register is set to -1 (7777777776) . 



Operator: 



Packet: 



TESTFLl 



|775/.0l201li 



•ESTABLISH ERROR ADDRESS (Function code 12) 

This request takes the .error address in B7 and places it in 
the task addendum. Address is relative lower lock of requestor. 
Control, can be transferred to this address in the event of a program^ 
error, e.g. memory references outside memory bounds, attempting to ' 
use privileged instructions. When operating with the TEST PACKAGE 
this function is reserved for 'its use. 



Operator: 
Packet: 



ERRADDlATag 



ENT^B7 



LABEL 



775^01201 12 



•ESTABLISH FLOATING POINT OVERFLOW ERROR ADDRESS (Function code 13) 

This request takes the floating point overflow error address 
in B7 and places it in the task addendum. Address is relative to 
lower lock of requestor. Upon floating point overflow program control 
is transferred to specified address with interrupt values in. A and 
Q registers. 



Operator: 



Packet: 



FOFADDlATag 
ENT^-B7 



LABEL 



■7 7 5 A 1 2 1 1 3 1 
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•ESTABLISH FLOATING POINT UNDERFLOW ERROR ADDRESS (Function code U) 

This request takes the floating point underflow error address 
in B7 and places it in the task addendum. Address is relative to 
lower lock of requestor. Upon floating point underflow program 
control is transferred to specified address with interrupt values 
in A and Q registers. 



Operator: 
Packet: 



FUFADDlATag 



ENT^(-B7 


LABEL 


7 7^40 


2 1 1,3 



•ESTABLISH ILLEGAL OPERATOR ADDRESS (Function code 15) 

This request takes the illegal operator error address in B7 
and places it in the task addendum. Address is relative to lower 
lock of requestor. Program control will be transferred to specified 
address when ever program executes an illegal instruction code. 
When operating under control .of TEST PACKAGE function is reserved 
for its use. 



Operator: 
Packet: 



OPADD^ATag 



i!;NT^-B7 



LABEL 



7754 1201 1 5 



•TEST FILE CODE FOR PERIPHERAL TYPE (Function code l6) 

This requests the numeric peripheral type code of the unit 
or mass storage assigneu oo uu6 j.ij-e coue conoaineu in uue ^ regxsosr. 
File code is in its field data form. 



Operator: 
Packet: 



TFC^Afile code 



ENT^O, 


File Code 


7 7 5 4 


2 1 16 



Numeric peripheral type is returned in the "A" register right 
justified. If device is random access, the number of words allocated 
to file code will be returned in the Q register. 



•REQUEST CORE SIZE (Function code 17) 

This request will supply three pieces of information: the 
lower lock address (in A); the RIR (in Q) and the number of words, 
in binary, allocated to the program (in B7) 



Operator: 
Packet: 



TCORE$ 
I 7 7 5 Z. Ol 2 1 1 7l 
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•SET IF?. 15 BIT B REGISTERS (Function code 20) 

This request will set the B register mode bit in the IFR for 
15 bit B registers. All normal worker programs are original 
established in this mode. 

Operator: SET1 5$ 

Packet- [775A01201 2 61 

•SET IFR FOR 17 BIT B REGISTERS (Function code 21 ) 

This request will set the B register mode bit in the IFR 
for 17 bit B registers which is the abnormal mode of operation 
reserved for EXEC, RT/GOMM, etc. 

Operator: SET17I 

Packet: ■ 17 75^0(201 2 1"! 
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6,5 Console Control 



01 


Unassigned 


02 


Unassigned 


03 


Unassigned 


04 • 


Unassigned 


05 


Unassigned 


06 


Unassigned 


07 


Unassigned 


10 


change! 


11 


mount! 


12 


unmount! ' 


13 


LOG$ 


U 


MOUNTN' 


15 


CHANGEN 



Operator directives with regard to files 
Operator directives with regard to files 
Operator directives with regard to files 
Submit systems information to log or console 
MOUNT without a delay 
CHANGE without a delay 
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•CHANGE FILE DEVICE (Function code 10) 

This is a standard method of notifying the computer operator that a particular 
file device (e,g,, a reel of tape) is to be labelled and unmounted and an 
alternate file mounted in its place « This operator is necessary for such 
communication since worker programs will not be allowed to use physical 
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channel/unit designations. Magnetic tapen will be positioned at the 
begimiing of the tape. The requesting activity will be delayed imtil 
the computer operator signals that the file has been changed. 

Operator: GHMGE$/iFile code, file identifiers 



Packet; 



i ■ 

EKFP^B? N 


FILE CODE 


FILE IDMTIFIEHS 


7754-0 


20050 



variable length and format 



N 



•KOMT A FILE (Function code 11 ) 

This request directs the computer operator to mount an input-output file 
on a particular file device* This operator is necessary for such comnmni- 
cation since worker programs will not be allowed to use channel/unit 
designations* Magnetic tapes will be positioned at the beginning of the 
tape. The requesting activity will be delayed until the computer operator 
signals that the file has been mounted* 

Operator; MOUA-TOAFile code, file identifier 



Packet: 



1 

SBJP^B7 


N 


FILE CODE 


FILE IDENTIFIER 


77540 20051 

• 



variable format and length 



N 



•DISMOLT^T A FILE (Function code 12) 

The computer operator will be requested to dismount an input-output file 
from a particular file device and properly label it. The task will be 
delayed until the computer operator* signals that the file has been dismounted, 

Operator: DISM0MT$4File Code, file identifier 



SBJP^B7 



N 



FILE CODS 



FILE IDENTIFISE 



77540 



20052 



variable length and format 
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*LOG (Function code 13) 

This is the standard method of sending a message to the computer operator 
and/or entering data into the systems log. If data is being entered into 
the systems log, it may also be typed on the computer operator's console. 
An optional delay after a message is typed out on the console can be 
requested to allow the computer operator to perform some action. 

Operator: LCGvjAOptions A literal 

where "literal" is the message to the computer operator 
and/or data to the systems log* 



The options are: 

T= Type message on console^ no delay 

E = Type message on console, wait for operator response 

L = Enter literal into systems log 

A blank field is equivalent to the T option. 



Packet: 



KB,TP*B7 


N 1 


OPTIONS 
& 

LITERAL 


7754.0 


20053 



variable length and format 



N 



\Ihen control is returned after a log request with R option the Q register 
may contain 1 to 5 characters as a responce to the delay and are useable 
by the requestor. 

.KDU:i«'T A FILE - NO DELAJ. (Function code 1 4.) 

This request is almost identical to the MODNT^ operator. It directs the 
computer operator to mount an input-output file on a particular file device. 
However, no delay will be initiated. The task will be contined after the 
console typeout. 

Operators none 
Packet: 



EBJ?^37 



FILE CODE' 



FILE IDENTIFIER 



77540 



2005-4 



variable length and format 
N 
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'DI^ii'iOUiYT A FiiiE - iSfO dj^jlAi U'unction code 15; 

This request is similar to the DISMOUNT^ operator* It directs the computer 
operator to dismount an input-output file and pt>perly label it* No delay 
will be initiated. The task will be continued after the console . typeout. 

Operator; none 
Packet: 



variable length and format 

N 



•CHiiXGS FILE DSVICS - NO DSLAI (function code 16) 

This request is similar to the CHMGE$ operator. It directs the computer 
operator to dismount a file, label it, and mount an alternate file in its 
place. No delay will be initiated* The task will be continued after the 
console typeout* 

Operator: none 



! 
EBJP^B? 1 N 


FILE CODE 


FILE IDENTIFIEE 


7754-0 


2C055 



E3J?^37 


N 


FILE GODS 


FILE IDENTIFIEH 


77540 


20056 



variable length and f ozmat 

N 
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6.6 Facility and Storage Assignment - Library number 005 is a non 
re-entrant routine responsible for processing the follovdng 
service requests. 



Description 

Assign designated facility to task 
Release designated facility from task 
Switch units assigned to file codes 
Release all non-hold assignments 
Release all assignments 
Assignments submitted by selection 
Switch submitted by selection 



Function 




Code 


Operator 


01 


ASG§ 


02 


FRKF.§ 


03, 


S^HTCHS 


OA 


Internal 


05 


Internal 


06 


Internal 


07 


Internal 
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Functional Description of Function Codest 



Function Code 01 - Assignment Request 



Caller: 

Parameter: 

Addendum: 
Function: 



Exits: 



A task/activity requesting the assignment of a 
peripheral through the control statement interpreter 
or an internal request made at execution time. 

B7 = the address of the ASG statement relative to 
the lover lock of the requestor,. 

Worker task/activity addendum 

a) Unstring the control statement 

b) Read in the facility map 

c) Locate the peripheral name requested 

d) Make an assignment from the peripherals listed 
under that name and build associated tables.' 

e) Load the associated handler if not in core 

f) Initialize the unit as prescribed by options 

g) Set up log function for assignment printout 
h) Switch to log routine for printout and delay 

DRET$ to control supervisor, B1 = j^ B2 = console 
control. 



T^oti 



Status i 



A = logical address if mass storage assignment or 

P-TYPS, CHAN/UNIT if unit assignment. 
A = 777774OOXX implies unsuccessful assignment 



Function code 02 - Free request 



Caller: 

Parameters : 

Addendum: 
Function: 



A task/activity requesting the release of a 
peripheral through a control statement or an 
internal request, 

B7 =• the address of the free statement relative 
to the lower lock of the requestor. 

Worker task/activity addendum 



a) 
b) 

c) 

d) 

e) 



g) 



Unstring the control statement 

Locate the mass storage list or UCB associated 

with the file code specified. 

Release the storage or units from core summary 

Release core used for random access storage 

list and UCB. 

Go to master file directory routine if the 

file is to be registered 

Prepare a log message for the console 

Switch to log routine for printout 
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ii;Xits: 



DRiiiTl$ to content supervisor B1 = 1 B2' = console control 



Returned 
Status : 



A^. implies successful completion of release 
A = 77777400XX implies abnormal condition such as, 
the file code not being assigned.' 



Function Code 03 - Switch request 
Caller: 



Parameter: 

Addendum: 
Function: 



Exits: 

Returned 
Status : 



A task/activity requesting the switch of two 
file codes through a control statement or an' 
internal request made at execution time, 

B7 - the address of the FREE statement relative 
to the lower lock of the requestor. 

Worker task/activity addendum 

a) Unstring control statement 

b) Locate file codes 

c) Switch the links to the unit control blocks 
under the individual file codes. 

DRST1$ B1 = Return to requestor 



A^O implies successful completion 

A = 777774-0001 implies necessary parameters were 

not present 
A = 7777740002 implies an invalid file code was 

specified. 



Function code 04 - Release all non-hold assignments 

Caller: Termination upon the termination of a task. 



Parameter: 

Addendum: ---^ 
Function: 



Exits: 



All parameters are available within the addendum 
which is currently activ. 

Worker task/activity addendum 

a) Make a pass on the file code list erasing 

UCB links of all units not in a hold condition, 

b) If unit is currently active delay until , all 
requests are complete and thendeallocate 
any random access storage list and UCB. 

c) Update accounting information in job description. 

d) Release units or storage to system. 

e) Release locks on released areas. 

DRET1$ B1 = return to requestor 
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ninction code 05 - Releas^ all assignments 

Caller: Termination routine upon job termination 

Parameters s All parameters are available within the addendums 
which is currently active. 

Addendum: Worker task/activity addendum ■ 

Function: Same as function code. 04 except that .ail files 
assigned to the job are released.. 



Function code 06 - Assignment of a peripheral requested by 

initiation. 



Caller: 

Addendum: 
Function: 



Exits: 
Returned 

Stntiis! 



Initiation upon the processing of pre-load time 
facility requests . 

Worker task/activity addendum 

a) Same as function code 01 except a special 
entrance is used for entry into the log 
routine which will disregard any delay 
request and return to initiation with the - 
status in the A register as before and the 
peripheral name under which. the assignment 
was made. 

DRET1^ B1 = 1 B2 - console control FG XX 



Same as Function code 1 



Function code 07 - Switch of two file codes requested by initiation 

Caller: 



Addendum: 

Function: 

Exit: 

Returned 
Status: 



Initiation upon the processing of pre-load time 
switch requests. 

Worker task/activity addendum 

Same as function code 03 except for a special exit 

DRET1I B1 = 1 B2 = initiation (selection FC 05) 

Same as function code 03. 
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6.6.1 Method of Operation 

The ASG service request prepares a file for use by setting up 
a unit control block according to the specifications implied by 
the assign statement parameters and the particular device 
assigned. 

The sequence of functions em,ployed to process an assign control 
statement are as follows: 

a) Unstring ASG control statement 

b) Locate given peripheral code which will identify peripheral 
type desired and required device handler. Check availabilty 
of device or storage in "facility and storage summary" if 
available continue, otherwise exit. 

o) Reserve indicated device or storage in siammary. Read, in 

device descriptor and form unit control block setting options 
for peripheral and lo^d, if not currently active, device 
handler. Set file code increment to unit control block and 
set RIR and Drum increment of device handler in unit control 
block. 

d) Perform operator type-outs directing tape mounting or' 
retrieve file descriptors for random access storage. Exit 
upon completion of above. . 

d) Maintain 1:^ Job # a list of all facilities assigned* 
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ASSIGN Statement Foimat and Interpretation 



Format 

1 ,2 3 4. 

# ASGr ^ Options /\ Peripheral Name, File Code, Estimate, File Identification 



Interpretation of Parameter Fields 
Peripheral ... ; Meaningful Options 



\/ 



TAPE 



E,0,E,M,L,J,R, 
S,T,V,W,U,N 



MASS STORAGE J,S,V,H,M,L 

PRINTER J,V,W 

CARD J,T,V,W 

PAPER TAPE J,V,W 

CORE J,S,V,W 

COMM 

Option Meaning 

Option Letter 

E 



H (TAPE) 

(MASS STORAGE) 
M (TAPE) 

(MASS STORAGE 
L (TAPE) 

(MASS STORAGE) 



Required Parameters 
1, 2 

1, 2 

1, 2 

1, 2 

i, 2, 

% 3 



Optional Parameters 
3, 4 

3, k 
3, ^ 
3, 4 
3, 4 
, 4 



Meaning 

- Even parity (compatible mode) applicable on compatible 
units only. 

- Odd parity (Binary) assumed if no or E option present. 

- Highest density applicable to the subsystem (800 ppi) 

- High grade mass storage requested. 

- Mediiam density applicable to the subsytem (556 ppi) 

- Medium grade mass storage requested. 

- Lowest density applicable to the subsystem (200 ppi) 

- Low grade mass storage requested. 

-■ Hold assignment for duration of job unless explicitly 
released. Absence of the J option implies assignment 
will be released upon termination of the task. 

- Rewind the assigned unit without interlock. 
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Meaning 



S 
T 

V 
W 

U 

N 



- Declares the file is in the Master File Directory 

- Translate from FD, to BCD coming in and from FD to 
BCD going out. (Applicable on compatible units with 
translate hardware.) 

- Assignment not required for the execution of the task. 

-Wait for operator response after file identifier . is 
printed on the console printer. 

- Indicates automatic block numbering is to be applied 
to any tape files written. 

- Implies the noise record constant defined at system 
generation will be applied. 



Peripheral Name Interpretation 

The peripheral name is a mnemonic name of up to five characters in length 
which dictates a set of units acceptable for assignment on this request. 
A set of standard peripheral names are used by the system and any user* 
Additional peripheral names may be defined at system generation time* A 
list of the standard peripheral names and their names appears below. 



TAPE 
M3C 
UN6C 
UN8C 
CRIN 

PTIN 
PTOUT 
PRINT 
RAN 

mN 

FH4.32 
FH880 
SEQ \ 
CORE 



Any UNISERVO 

UNISER70 IIIC 

UNISERVO VIC 

UNISERVO Vine 

Card Reader other than primary input 

Card Punch other than seoondarv out'out 

Paper Tape Reader 

Paper Tape Punch 

High Speed Printer other than primary output 

Any random access device 

FASTRAND 

FH432 Drum 

FH880 Drum 

Any sequential file devioe (random access on tape) 

Additional core adjacent to end of routine. 



O sO"» Y 



File God6 Int-srprs'ts.'tD.on 



The file code is an alphabetic character by which the unit assigned will 
be referenced in input, output operations. The characters A through Y are 
available for general use. The character Z is reserved for the system files. 

Each letter A-Y may be broken into subsets of 26 double file codes, for 
example A could be broken down into. AA, AB, AZ» 

The system file code is broken down into' a subset containing double fil© 
codes. The system file and their assigned file codes appear below. 



ZA 
ZB 
ZC 
ZD 
ZE 
ZF 
ZG 
ZH 
ZI 



Primary input unit record 

Primary output unit record 

Secondary output unit record 

Cooperative library 

Systems library 

Job library 

Systems log 

Scratch 

Scratch 



• Estimate Interpretation 

The estimate parameter has different meaning depending on the type of 
peripheral. A list of the interpretations for different peripherals 
appears below. 



TAPE 



MASS STORAGE 



PRINTER 



CARD . 

PAPER TAPE 
CORE 



blank (unless a sequential file is requested, in which 
case the estimate would be of the same form as that of 
mass storage. 

[minlmua/maxiMumJ (defines the minlnrum and the mximmi 
amoimt of storage requested. If available the maximum 
area or any amount down to the minimum is assigned. If 
the minimum acaount is not available a non-assignment 
status is returned. 

Carea] (defines an amount of storage requested. If no 
V option is present the area is taken as the minimum 
amount of area that is acceptable. If a V option is 
present any part of the area requested that is available 
is assigned. 

CJM/[iM/PL3 (UM defines the upper margin, LM defines the 
lower margin, PL defines the number of printable lines 
on a page. If this parameter is absent the standard 
system format will be assumed i 

Blank . 

Blank 

Same interpretation as mass storage. 
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6*6*2 Periphei^l Unit Assignment 



Facility map is a drum stored table describing peripheral •units 
and their device handlers. This table is used by facility 
assignment to assign facilities and initialize request lanits 
and locate their appropriate device handler. The file increment 
to the facility map and its length are maintained in the core 

summary (Table ). The address of which is provided by the 

content saper-visors in B5. Words 1 through N and X through X+N 
define grouping of peripherals under specific peripheral names. 



N 

X 

X+1 

X+2 
X+3 



^ TO UNIT LIST 



^ TO HMDLER LIST 



PERIPHERAL NAME 1 



B 



B 



^25 ^ 

^ E/iNDLER DESC. 



V HANDLER DESO. 



TZT 



UNIT DESG. 



T7 



UNIT DESC. 



PERIPHERAL NAME 2 



A 



B 



B 



^ 



HANDLER DESC, 



HANDLER DESG. 



xz 



tJNIT DESG. 



UNIT DESG. 




Word 



Word 1 



U -> The increment from the base of the map to the 
first unit description. 

L - The increment from the base of the map to the 
first handler description. 

A peripheral name by which assignment will be requested. 
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Word 2«3 



Word X 



2^*^ (A) If set 2^*^ indicates the end of the 

list under this peripheral name* 

2^^ (B) Undefined. 

tP (C) Undefined. 

ok 16 
2^"-2 ^ The Index to the handler description to be 

used on this assignment. This index is relative to 

the "base of the handler descriptions list. 

2^-2 The index to the unit description to be used 
for assignment. This index is relative to the base 
'of the unit description list. 

Another peripheral name under which assignment is 

xaade. 



Word X+1-X+3 Describe the units and handler to be assigned under 
this peripheral name as do words 2-3. 



Device Handler Description 

To provide flexibility required to allow several distinct device 
handlers to be eligible for control of a particular device, the 
peripheral mnemonic specifies both unit and handler as determined 
at systems generation time. At time of assignment OMEQA will 
check to see if requested handler is in core. If it is, assignment 
will be linked to it; it not, handler will be loaded and registered. 
The handler name and version is overlaid with the handler load 
information (0A-2A) at initialization time. 





1 

2 

OA 
1A 
2A 



HANDLER 



NAME 



VERSION 



29 



17 



HANDLER LENGTH 



16 

i OR HANDLER ADDR. 



PILE INCRMENT TO HANDLER 



n 



# 'ASSIGNMENTS 



Word 



0-2 
OA 



contains name/version of device handler 

contains absolute address and length of routine i the 
absolute address. is /Zi if the handler is not in core* 
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Word 1A ' contains drum address of routine 

2A Number of assignments currently made to routine, 
if J^ handler will be purged from core when 2^^"^^ 
is equal to j^. 2^^"^^ set to one indicates once 
handler is loaded it is to be retained as a - 
permanent resident. Initialization number refers 
to the proper routine to initialize the unit "for 
the particular handler. • 

Unit Description: 

Contains infoimation pertinent to the particulsir unit. 



Word 


1 
2 



P - T2PE 


LMGTH OF DESCBPT 


CH/DNIT 


CH/UNIT 




LENGTH OP UCB 


Information Pertinent • 
to Unit 




^~~^--.^^^__ 



Word . ■ ' contains peripheral i^ype number recognized by the 

flvg+. gT n ainA S nf words Contained in unit description* 

•1 contains ch and unit of device if dual channel both . 
upper and lower will contain an entry. 

2' contains the length of the unit control block that 
will 'be formed upon assignment. 

3 N contains information used by facility initialization 
and/or to be contained in UCB. 



Peripheral Types: 

Each type of external peripheral de^ioe is desoribed to the system 

«t g^mi%u,Q^ '^SJm ^f&ugh use @f « i^\isiiii^« 

Mass Storage Devices 

00 Fa432 Drum subsystem 

01 FH880 Drum subsystem 

02 Modular PASTRAND 

03 TkSITsMD I 

04 FASTRAND II 
05-07 Unasslgned 
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■ f 

Mass Storage Devices (contlmied) 

^ 1' ■ . •'. 



15 
16 
17 



milSERVO IIIA 



Unit Record Devices 



20 

21 

22 

23 

24 

25 

26 

27 

30 

31 

32 

33 

3h 

35 

36 

37 



High Speed Card Reader 
High Speed Card Punch 

High Speed Printer 
1004 Reader 
1004 Punch 
1004 Printer ^ 

Paper Tape Reader. 
Paper Tape Punch 



Pacility and Storage Summary 

As part of the resident EXEC element, a summary of peripherals 
available is maintained along with the random access storage 
summaries* 



Word 




-■ 










' : 


ADDRESS OF FREE CORE CORE ; 


. ■■ ^ .: - '\ 


. ■ FILE INCREMENT TO FACILITY MAP 


2 :^\':' '\.-y- 


LENGTH OF FACILITI MAP 


■ ■•■ 3 ■ ■ •■■' 


i?lLE INCREMENT TO SELECTION MAP 


4 


LENGTH OF SELECTION MAP 


5 


FILE INCREMENT TO JOB STACK 


6 


ADDRESS OF CHANNKL CONTROL BLOCKS 


7 


LOCK SETTING 


10 Channel 


A 


B 


C 


P-TIPE 


SUMMARI LENGTH 


A TO CHANNEL SUMMARI 


11 Channel 1 


A 


B 


C 


P-TIPE 


SDMMARI LENGTH 


A TO CHANNEL SUMMARI 


! i 


] 


V 33 Channel 23 


A 


H 


C 


P^TIPE 


SUMMARI LENGTH ^ TO CHANNEL SUMMARY 


,-.'.■■'■• ^ ■ 


L—..^ — , ■' cmimm. .qnwMAPY 
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As part of the resident EXEC element, a summary of available 

peripherals is maintained along with a series of values required 

by the secondary EXEC routines. Any reference to this summary 
snould use the mnemonic increment indicated on the description. 

Word The address of the free core chain. (FSFCC) 

• " 1 The file increment to the facility map on the system 
; library file (ZE) . (FSIFM) 

2 The length of the facility map on the systam library 

file. (FSFML) ' 

3 The file increment to the selection map on the system 
library file (ZE). (FglSM) 

4- The length of the selection map on the system library 
■ file. (FSSML)' 

5 The file increment to the job stack module on the 
cooperative library file (ZD). .(FSIJS) 

6 The address of the channel control block list. (FSACCB) 

7 A lock location used to lock out references to the 
facility and storage summary. (FSLS) 

10 2^9 (a) set to 1 when peripheral on the channel are 

depleted. (FSGS) ' . 

2^^ (B) When set an IOC occupies 'the channel. 
2^'7 (Q.) Undefined 

?A 21 
2^° - 2 . A number defining the specific type of 

peripheral. 

220 » 2^ The length of the channel : summary. 

2^^ - 2 The index to the channel summary relative, to 
the base , (WORD 0) . 



Peripheral Entry J 
Channel Summary 



Channel Summary 1 



MASTER BITS LEFT JUSTIFIED 



MASTER BITS LEFT JUSTIFIED 



One bit is reserved for each unit on the channel. The bits are 
justified left. If a bit is not set, the corresjjonding unit is 
available. If the bit Is et the unit is not available. 
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6«6,3 Eandom Access Drum Allocation 

Assignment of random access storage is in fixed modules the 
size of which is dependent upon the type of device and ntimber 
of units on a channel. Each channel contains a summary-composed 
of a bit map used to reflect the availability of modules and 
develop their starting addres; ^and, a simmary used to reduce 
search time required for assignment. The Drum summary is main- 
tained "by facility assignment inlhe first one or two modules 
of the described storage. 

The folloidjig table contains module size utilized 1:^ UNIVAC to 
allocate random access storage. Values and mapping may be 
changed to reflect installation needs. . 

FH4.32 Drum - capacity per drum 262,126 words 



# of . 


.# Words 


# of Length of 


#of 


Drums 


Tier mod; 


Modules ■ ■ ■ Summarv . 


Modules' 


\ 


128 ■ 


2,048 . 97 


1 


2- 


256 


2,048 • ■ 164 ■ 


1 


3 


256 


. 3,072 .231 


1 


U 


256 


4,096 298 


2 , 


5 


25.6 


5,120 365 - 


2 


6 , 


256 


6,144 432 


2 


7 


51^2 


3,584 499 ' ' 


1 


8 


• 512 


4,096 566 , 


2 ' 


9 


512 


4,608 633 


2 


1880 Drum 


- capacity per drum 786,43.2 words 


' 


# of 


# Words . 


# of Length of . ' 


# of 


Drums 


Der mod. 


Modules Summary ■ 


Modules 


'1 


256 


. 3,072 143 




2 


256 


6,144 : 255 




3 


< 512 


4,608 184 




U 


512 


6,144 235 




5 


512 ■ 


7,680 286 




6 


512 


9,216 . 338 , 




7 


512 


10,752. 389 . 




a 


512 


12,288 440 . 


,-' 
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FASTRAND I - Capacity per unit 12,876,128 words (See Note 1) 



#GF 


# WORDS 


#0F 


LENGTH OF 


UNITS 


PER MOD 


MODULES 


SUMMARY 


1 


2,112 


6,U^ 


235 


2 


. 2,112 


12,288 


440 


3 


2,112 


18,4.32 


645 


k 


2,112 


24,576 


850 


5 


2,112 


30,720 


1,055 


6 


2,112 


36,864 


1,260 


7 


2,112 


43,008 


1,465 


8 


2,112 


49,152 


1,670 



FASTRAND II - Capacity per unit 25,952,256 words (See Note 1) 



#0F 


# WORDS 


#0F 


LENGTH OF 


UNITS 


PER MOD 


MODULES 


SUMMARY 


1 


2,112 


12,288 


440 


2 


2,112 


24,576 


850 


3 


2,112 


36,864 


1,260 


4 


2,112 


49,152 


1,670 


5 


4,224 


30,720 


1,055 


6 . 


4,224 


36,864 


1,260 


7 


4,224 


43,008 


1,465 


8 


4,224 


49,152 


1,670 



Note 1. Allocation module size is be sector to allow "SEARCH" track functions. 
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Random Access Summary 






1 Channel # 


Peripheral type. 


1 


Capacity of Channel 


2 


Available Capacity of Channel 


3 


# of words in module . ^ of words in sector 


4 


# modules currently available 


5 


Word count of last search 


Length of bit map 


6 


# of times bit map referenced 


7 


# of times reference futile 


10 


Physical address of Group 


11 


Physical address of Group 1 


12 


Physical address of group 2 , 


13 


Physical address of group 3 


U 


Physical address of group U 


15 


Physical address of group 5 


16 


Physical address of group 6 


17 


Physical address of group 7 


20 


^ of Modules available in group ^ 


21 


^ of modules available in group 1 


22 


it of modules available in group 2 

■ 


23 


# of modules available in group 3 


24 X 


# of modules available in group 4 


25 


# of modules available in group 5 


26 


# of modules available in group 6 


27 


# of modules available in group 7 



An effort is made through allocation to maintain 4 groups ^ich represent l/2, l'/4> 1/S 
and 1/16 of available storage, allowing the other 4 groups represent continuous areas 
of random length. 
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Bit Map 

Bit maps are of variable le2:igth dependent upon module size and § of word positions 
assignable on channel. Each bit position within a bit map declares if the corresponding 
module is free (j2f) or is reserved (1) and is used to map into a physical address, 
relative to zero, of the module, p 

Physical address X (30 X word position + bit position) X (Modtile size) 
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6.6.^ 

Master File Directory 

Description 

The Master File Directory catalogs all mass storage files and/or tape files held 
permanently or semi-permanently by the system. The directory may be constrained 
to a maximum size at systems generation ■ time and/or extended during operation. 

The purpose of the Master File Directory is to retain files between jobs or between 
the repetition of a given job. The user is releived of the responsibility of deter- 
mining at object time physical location of the file and may extend, contract or . 
delete the file during execution. 

Interface 

Entries in the directory are cataloged by a formal request. Each request for a file 
must use a numeric key 3-7 digits as set gy Systems generation denoting his user 
number and a niameric key 3-7 digits defining his file number. User obtains assign- 
ment of a file through use of the i.SG control statement and may register an updated 
version through use of the FREE control statement. 

Directory Index 

Number of entries in the directory index is detemiined at systems generation time by 
specifying the number of user indexes desired. For each index assigned an -additional 
index is required to supply number of files qualifiers contained, and 7 digit . account 
number to which charges for storage space are to be made. Directory index #000 is 
general and reserved for semi-permanent files. 



Directory Index 



Channel 
# 



Physical address of File Index 



All binary 1 ' s 
if \inas signed 



Directory index is composed of one word entries ordered by user number and 
covers the span of user numbers defined at systems generation time. 



File Index 



Channel 
# 



Physical address of File Qualifier 



Each file index is composed of one word entries ordered by file number and 
covers the range of file numbers defined at jystems generation time. 
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File IJualifier 




1 
2 
3 

5 
7 



N 



^ Character password for file reference 



Date of 1?^st. nh^jTigft tn f n 1 p. 



# of references since 
last purge ^ 



.# of days? .to rfit.fiin 



# constituting a unit . current § of units 
Total # of units to date 



File type 



§ of words in descriptor 




Password 

The five character password may be employed to control the use of confidential data 
and prevent unauthorized access. For each request for assignment of a protected 
file, the user must present with the user and file number, the designated password. 
Any attempt to request assignment of a protected file without the password will 
cause the Job to be aborted with appropriate messages. 

Words 1-2 

Each time a file is explicitly released to the system, date is changed to current date. 
Number of references since last purge is a count of file assignments made to operating 
tasks of current file. Number of days to retain is a number supplied by the user 
specifying the number of days file is to be retained in the directory after last 
change. 

Periodically mass storage files which have expired number of days to retain will be 
recorded on magnetic tape and their assigned mass storage will be released to the 
general pool. At time of purge, a summary of deleted files will be submitted to 
primary output cooperatives listing file characteristics and accounting data. 

Words 3-4 

Are used to maintain accounting information. "Number constituting a unit" is a user 
specified value normal number of words of mass storage to be used for accounting pur- 
poses per unit of time. Unit time is assumed as a day. "Current number of units is 
the largest size of the file for any one day. 
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"Total number of units to date" is a cumulative total of units for the file; 
updated each time file is rerequested in the system. 

Word 4 = (current date - word 1) • (current # of units) + word, 4 



File Descriptors 



Jlle descriptors are used to describe the physical characteristics of the file, 
are maintained by the system and are of two types, mass storage and tape. 



These 



Mass Storage 



Channel # 



Physical address of block 1 



# of words 



Qhannel # I Physical address Qf .block 2, 



U 



S n-P vr>rHg 



# of words 



-J 



External Tape Files 



Physical tape # (operator directive) 



Symbolic name of unit 



Recording options 
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File Access 

Access to a file contained in the Master File Directory cannot be perfonned until an 
ASG control statement is given specifying the file code to be used, user number, file 
number and password if required. Example: A request for file number 932 under user, 
index 035 to be assigned to file code B would appear as follows: , 

ASGA^RAMjB, 035/932 

Once assignment has been made, the user activity may perform all packet level or 
file control I/O commands available in the system including extension or contraction 
of file. However, if user has changed the limits of the file, he must reregister file 
through use of FREE control statement in order to maintain update. Example; the 
above file being reregistered in the directory wo\LLd appear as follows: 

FREEl^AB,. 035/932 
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6.6*5 Facility Assignment Initialization 

Parameters required for system generation used to form systems 
records and/or initialize facility assignment according to 
configuration and/or desired is er options . 

a) For each channel of subchannel, the following information 

is required: 

. Channel number 

* Peripheral type 

. Mnemonic name of peripheral type " 

, Number of units . 

. Cost per unit of time for user to' retain word or device. 

. Name of handler responsible for channel or subchannel 

b) Option for accounting information 

. Normally accounting method is a summary of units assigned 
to Job. 

£( (Length of time held x number used) cost per unit time) 

. Option method is to submit to systems log each assignment 
listing type of device, number of Mnita and length of time 
retained. 

c) Establishment of User Index 

. 0-7 digit number of user indexes 

. Channel number on which user index shpuld be maintained, 

d) Establishment of qualifier index 

User index number 

Accoiint number 

Number of files 

Optional. Password 

Channel number, pn which index should be maintained 
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6.7 Service Function 3 - Library number OOo is a non-reentrant routine ; 
used to create and release core chains ^ process Send and Receive 
requests, simulate hardware search, and Retrieve an element. 



Function 
Code 

01 

02 

03 

OU 

05 

06 

07 

10 
11 
12 
13 

u • 

15 
16 
17 
20 
21 
22 

23 



Operator 
FCHAINl 
RCHAIN$ 
Unas signed 

send! ■ 

RECEIVE. 
SEARCHi 

Unassigijed 
Unassigned 

SENDP 

RECEIVEP 

Unassigned. 

SEARCHTL$ 

SEARCHPLi 

SEARCHL$ 

BL0CKSL$ 

FETCH$ 

FETCHR$ 

FETCHL$ 

FETCHRQl 



2U 


Unassigned 


25 


Unassigned 


26 


Unassigned 



Description 

Form a core chain 

Release a core chaip 

Transmit parameters to Exec storage' . 

Complement of SEND 

Simulated hardware search through 
repetitive read. 



Send parameters 
Receive parameters 

Search track and lock 

Search position and lock 

Same as SEARCH$ with lock 

Block search on drum with lock 

Load absolute element in assigned core 

Same as FETCH$ with activity registration 

Locate named element and read the table 
of contents for that element. 

Same as FETCHRl with queued activity- 
registration 



27 



Unassigned 
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Service Functions - Library mamber 006 is a nbn-re-entrant service 
routine used to process the following service requests. 



•REQUEST CHAIN (Function code 01) ■ . . 

This request will allocate core chain. These chains are available 
to RT/coimn only and can be used to iload worker programs, buffers or 
data pass areas. Each link will be a continuous memory area; links 
within a chain will occupy contiguous areas of memory. Links will be * 
obtained from free storage. During peak periods of processing, RT/comm 
may establish additional chains, at the expense of lower priority 
programs,: to accomodate overflow. 

Each chain must be assigned a unique number. Since numbers 0-5 
are reserved for the executive, this number must be 6 or more. Links 
within a chain may be declared either fixed module or variable length. 
The fixed module chain is composed of links of a. specif ied size. 
These modules are requested one at a time as needed. The fixed module 
chain has the advantage of having a faster request/release mechanism 
as well as requiring one less parameter at usage time. The second 
type of chain, variable, allows "the user to variable sized pieces of 
core. This type of chain is more flexible ' than the fixed module chain 
and wastes less memory, • . 

The number of words in the chain (variable chain), or per module 
(fixed module chain) must be an even number, i.e.,- divisible by 2. 
If the parameter V1 is not an even number, 1 will be added to it to 
make it even. 



Operator: 



FCHAIN$AV0,V1 ,V2 



For fixed module chains: 

VO - chain number (from 6-N) j 

V1 - number of words per module; and 

V2 - number of modules 

For variable chains: 



VO - chain number (from 6-N) 

V1 - total number of words in chain; 

V2 - 



and 



Packet: 



ENT^B? 


VO 


ENT^O. 


V1 


ENT^A 


V2 


7 7 5 40 


2 ^ L ^ 



The A register will be set zero if request completed, negative 
if core not available. The Q register will contain the number of 
words or modules allocated. 
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•RELEASE CHAIN (Function code 02) 

This request is used by a RT/comm program to deallocate .a 
previously declared chain. Care must be used so as not to release 
the chain before all expansions have been returned to the general 
storage pool. 



Operator: 
where VO - chain number 
Packet: 



RCHAINlAVO 



ENT*B7 


VO 


7 7 5 40 


2 1 ii. 2 



TRANa4IT DATA (Function code 04) 



This request will transmit limited data sets from an activity 
or task to executive storage. This 'rfill allow an independently 
executed activity or task within the job to retrieve the transmitted ■ 
data by means of a REGEIVE$ operator. All transmitted data will have 
a five character . octal identification attached to it. This identi- 
fication will aHow the receiving element to specify a specific data 
set. This identification will not be transferred to the receiving 
element. It should be noted that once a data set is received by an 
independent element, it is purged from executive storage and cannot 
be received again. . , 



where VO 
V1 
V2 



Operator: 



SENDlAVO, V1,V2 



base address of data field relative to lower lock; 
number of words in the data field; and 
a 5 character octal identification (zero implies 
no identification.) 



Packet: 



ENT^BV 


Base Address 


ENT^A 


No. of Parameter Words 


ENT^Q 


Identification 


7 7 5 4 


2 ^ L L 



•RECEIVE DATA (Function code 05) 

This operator will transfer data from executive storage to the , 
requestor. This data will have previously been sent to executive 
storage by a SEND$ operator initiated by an independent or 
asynchronously executed activity or previous task. Data may have 
a unique identification attached to it by the SEND$ operator that 
transmitted it to executive storage. This identification will make 
it possible to select sets of data. In general, data sets with the 
same identification as the identification field of this operator 
(next page) will be received by the requestor in the order that they 
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were sent to executive storage, i.e., on a first in, first out, (FIFO) 
basis. The requestor will receive only that data that was transmitted 
by one SEND$ operation. Thus there may be more data in executive 
storage with the same identification. As a data set is transferred to 
the requestor, it is purged from executive storage. This function 
may also be used to transfer COMMON from one chained element to the 
next. This operator will not transfer control card data (see RECEIYEP^ 
operator) . 

When control is returned to the activity, the A and Q' registers 
will contain the following status information: . 



REGISTER 



CONTENTS 



Number of data words transferred to receiving field. 
Q set negative if no data for particular identifi- 
cation left to be transferred. 



A 



Set to 0. if data set fits within receiving field. 
Set non-zero if data set overflowed the receiving 
field. Receiving field will be filled with as much 
data as it will hold. A register will then contain 
number of words left in data set. Data transferred 
will be purged. Next RECEIVEl with this identifi- 
cation will transfer remaining, words of data set. 



Operator: 



RECEIVE$AV0,V1,V2 



where VO - base address of receiving field, relative to lower lock} 
V1 - maximum number of words in receiving field; and 
V.2 - 5 character octal identification (O implies no identifi- 
cation ' 



Packet; 



ENT^-B7 



ENT^-A 



ENT^Q 



7 7^40 



Base Address 



Field Size 



Identification 



2 1 A 5 



•SEARCH A FILE (Function code 06) 

This function will search a file in the forward direction for a 
block (called the find block) whose first word is equal to some specified 
searchword. If such a block is found, it is read into the buffer area. 
This read will be performed regardless of the lock setting of the 
buffer area (the buffer area will not be disturbed unless the proper 
block is found) . The search will continue until either the block is 
foiind or an end of file is detected. Control will not be' returned to 
the requesting activity until the search process has been completed. 
To avoid typing up the synchronizer, the search will be performed by, 
software; hardware seeirch features will not be utilized. Only one 
file or tape reel will be searched. 
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A search of a random access storage device is a fixed block 
search. The rromber of words parameter (V1) is the block size. The 
logical address of any block (excluding the first) will be the logical 
address of the previous block plus the number of words (Vl). 

If the search is successful, the find block will, be read into 
the buffer area and normal l/O status, with the exception of B7 and A, 
The A register will contain the logical address of the find block. 
B7 will contain the number of blocks searched (count includes the 
find block). .Tape files will be positioned after the find block. 

If the search is. unsuccessful due to end of file, E.O, F* status 
word will be returned in the A register ( if the search is unsuccessful 
for any other reason, the proper status word will be in the A register. 
B7 will contain number of blocks read. 

Operator: SEARCH$AV0,V1 ,V2,V3,V4 

where VO - file codej 

V1 - number of words in buffer area; 

V2 - buffer base relative to lower lock; 

V3 - logical address from base of file (normally used for 

random access storage devices); and 
V4. - 10 character octal searchword 



Packet: 



EBJP^B? 


N 


File Code 


Buffer Base 


Buffer Base 


• Logical Address 


Searchword 


7 7 5 /u 1 2 1 /u 6 



N 

Note: A buffer size of zero will turn this request 
into a locate function. Nothing will be read 
into memory if the block is. found. Everything 
else remains the same. 

•TRANSMIT CONTROL CARD PARAMETERS, (Function cde 11) . 

This request will transmit a limited set of parameters from a 
control card or an unsolicited operator type-in to executive storage. 
A worker program will then be able ' to retrieve these parameters by • , 
means of the RECEIVER^ or RECEIVE! operator. This function requires, 
that the base address, relative to lower lock, of the control card 
parameter field be placed in B7 and the length of the parameter field 
in the A register. 

Operator: SENDP|AVQ,V1 

where VO - is base address relative to lower look of parameter field 
V1 - contains number of words in parameter fields 
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Packet; 



ENTitB? Base Address 


ENT^A No. of Parameter Words 


1 1 5 LO 20151 



•RECEIVE CONTROL CARD PARAMETERS (Function code 12) 

This request will transfer control card parameters from executive , 
storage to the requesting activity.' These control card parameters will 
have been transmitted to executive storage by a SENDP$ operator. After 
the control card information is transferred to the requestor it will 
be purged from executive storage. Unlike the RECEIVE^ operator, all 
control card parameters, regardless of the number of different cards 
that are stored, will be received by the requestor. 

When control is returned to the activity, the A and .Q registers 
will contain the following status iriformation: 



REGISTER 



CONTENTS 



Q Number of words of control card parameters 

transferred to receiving field. Q set negative 
if no control card parameters left to be 
transferred. 

A Set to if parameters fit within receiving 

field. Set non-zero if parameters overflow 
" with as many parameters as it will hold. A 
register will then contain number of words of 
parameters left. Transferred parsimeters will 
be purged. Next RECEIVER^ will transfer . ■ 
remaining words of parameters. 

Operator: RECEIVEP$AVO , V1 

where VO - base address of receiving field, relative to lower 
lock; and 
VI - maximum number of wprds in receiving field. 



Packet: 



ENT»B7 



ENT^Q 



7 7^4-0 



Base Address 



Field Size 



2 15 2 



•SEARCH FASTRAND TRACK WITH LOCK (Function code U) 

This function is essentially a search track and REABL$. It is 
applicable to FASTRAND equipment only. The SEARCHT$, function will 
be a part of this routine. The user should be aware that the SEARCHT$ 
is a hardware function and installation standards regarding use of the 
SEARCKT^ operator should be checked before using the SEARCHTL$ operator.' 
This operator will compare the first word of consecutive FASTRAND sectors 
against a specified searchword. If the end of track is encountered 
before a match is made, the search is terioinated and an unsuccessful 
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search status code returned in the A register. If a sector is found 
whose first word matches the searchword, a READL$ will be issued for 
parameterized data transfer. If the area is locked out the read 
(and, therefore, the activity) will be delayed until the area is free. 
When the area is free, the block will be read into the buffer area- 
and entered into the lock list. The first word of the buffer area 
will be the searchword, i.e., the read begins from the searchword. 
For successful find the A register \f±ll be set positive and contain 
the logical address of the word oh, FASTRAM) that equalled the search- 
word. All other status , returns hold as stated for normal I/O. 



Operator: 



SEARGHTLtoO,Vl ,V2,V3,V4 



where VO - file code; 

V1 - number of words in buffer; 

V2 - base address of buffer, relative to lower lock; 
V3 - logical address relative to base of file; and 
V4. - 10 character octal searchword 



Packet: 



. EBJP^B? 


N 


File Code 


Buffer Length 


Buffer Base 


Logical Address 


Search Word 


775A0 12015A 



N 



If the buffer length is set to zero this request 
will become equivalent to a locate function. 
Nothing is read into core. The logical lock 
list is not consulted. Everything else remains 
the same. 



•SEARCH FASTRAM) POSITION WITH LOCK (Function code 1$) 

This function is essentially a search position (SEARCHP$) and 
READL$ operator. It is applicable to FASTRAND equipment only. 
The SEARCHPl function will be a part of this routine. The user should 
be aware that the SEARCHP$ is a hardware function and installation 
standards regarding use of the SEARCHP$ operator should be checked 
before using the SEARCHLP$ operator. This operator will compare the 
first word of consecutive FASTRAND sectors against a specified search- 
word. If the end of position is encountered before a match is made, 
the search is terminated and an unsuccessful search status code 
returned in the A register. If a sector is found whose first word 
matches the searchword, a READL^ will be issued for parameterized 
data transfer. If the area is locked out, the read (and, therefore, 
the activity) will be delayed until the area is free. When the area 
is free, the block will be read into the buffer area, and entered into 
the lock list. The first word of the buffer area will be the search- 
word, i.e., the read begins at the searchword* For successful find 
the A register will be set positive and will contain the logical 
address of the find on FASTRAND that equalled the searchword. All 
other status returns hold as for normal I/O. 
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Operator: 



SiiiARCHLPlAVOjVI ,V2,V3,V4 



where VO - file codej 

V1 - number of words in buffer; 

V2 - buffer base relative to lower lock; 

V3 - logical address relative to base of file; and 

V4 - 10 character octal searchword 



Packet: 



EBJP-^B? 


N 


File Code 


Buffer Size 


Buffer Base 


Logical Address 


Search Word 


7 7 5 A 12 15 5 



N 



Note: If the buffer size is set zero this request 
will become equivalent to a locate function. 
Nothing is read into core. The logical lock 
list is not consulted. Everything else remains, 
the same. 



•SEARCH LOCK (Function code 16) 

This request is virtually the same as the SEARCH$ operator. 






regarding normal and error conditions. There is one important 
difference between this operator and the SEAHGH$ operator. When 
a successful search occurs, the SEARCH$ operator performs the READ$ 
regardless of the logical lock status of the file. This operator 
does not. This operator performs a READL$ (this is only pertinent 
if the file is on a random access storage device) . If the area is 
locked out, the read (and, therefore, the activity) is delayed until 
the area is released. When the area is free, the read is performed. 
The accessed area will then be placed on the lock list. The request 
will go on to normal completion. 



Operator: 



SEARCHL$AV0,V1 ,V2,V3,V4 



where VO - file code; , 

VI - number of words in buffer area; 

V2 - buffer base relative to lower lock; 

V3 - logical address from base of file (normally used for 

random access storage devices); and 
V4. - 10 character octal searchword 



Packet.: 



EBJP^-B7 


N 


File Code 


Buffer Size 


Buffer Address 


Loffical Address . 


Search Word 


7 7 5 A ■ 1 2 r 5 6 



N 
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Note: A buffer size of zero will turn this request 
into a locate function. Nothing will read 
into memory if the block is not found. Since 
the find block is not accessed, logical lock 
will be ignored. 

•BLOCK SEARCH FH DRUM WITH LOCK (Function code 17) 

This function is essentially a block search that performs a 
READL on the find area. It. is applicable to Flying Head drum 
equipment (FH880, FH432, etc.) only. The function BLOCK$ will be a 
part of this routine. The user should be aware that BLDGKS$ is a 
hardware function and installation standards regarding use of the 
BLOCKS^ operator should be checked before using this BLOCKSL| operator. 
This operator will compare consecutive words on drum against a 
specified searchword. If an end of block sentinel (a word of all 
binary ones 7777777777) is encountered before .a match is made, the 
search will terminate and an unsuccessful search status code returned 
in the A register. If the find area is locked out the read (and, 
therefore, the activity) will be delayed until the area is free. 
When the area is free, the block will be read into the buffer area. 
The first word in the buffer area will be the searchword, i.e., the 
read begins from the searchword. The area that was read will be, 
entered into the lock list. The A register will be set positive 
and will contain the logical address of the word on druBi that equalled 
the searchword. All other status conditions hold as in normal l/O. 

Operator: BL0CKSL$AV0,V1 ,V2,V3,V4 

where VO - file code; 

V1 - number of words in buffer area; 

V2 - buffer base relative to lower lock; 

V3 - logical address relative to base of file; and 

V4. - 10 character octal searchword 

Packet: 



EBJP*B7 


N 


File Code 


Buffer Base 


Buffer Base 


Loffical Address 


Searchword 


7 7 5 AO 1 2 15 7 



N 

Note: If the buffer size is set to zero this request 
will be equivalent to a locate function. 
Nothing will be read into core. The lock list 
.will not be consulted. Everyting else remains 
the same. 
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•SUBROUTINE LOAD (Function code 20) 

This operator will load a named absolute library program into a 
specified location. This is not a segment but rather a subroutine 
load. The operating task can control operation of absolute programs. 
The program that is loaded will not be activated until a fragmentation 
request is made. The operating base and memory lockout protection 
associated with the fetched subroutine is a subset defined by the 
requestor through activity registration* If the request is siuccessfully 
completed, the A register will be set positive. If the subroutine 
could not be loaded, the A register will be set to the appropriate 
systems status code. 

Operator: , FETCH$AV0,V1 ,V2 

where VO -'base address, relative to lower lock, of core area 
where subroutine is to be loadedj 
V1 - name/version of called element; and 
V2 - library in which call absolute element is contained. 
This may be 

SYSTEM - systems library 

JOB - ;)ob library 

GROUP/library number - named group library previously 

linked to' nob. If field is 
blank, the job library is 
assumed. 



Packet: 



EBJP^B? S + 7 



Base Address 



N--' ---N 



-N 



V --V 



Library Type 



Library Number If Group Lib (O IF NA) 



7 7 5 A I 2 16 



Note: The base address must be a multiple of 100 (octal), 
i.e., the two right hand digits must be 00. 



.LOAD SUBROUTINE AND REGISTER AS ACTIVITY (Function code 21) 

This function is a combination of the FETCH$ and REG$ operators. 
The requested subroutine will be loaded into the specified core area 
and registered as an activity. The user is directed to the documenta- 
tion for each of these requests for details. For this request, the 
base address of the FETCH$ function will be the same as the address 
of activity in memory of the llEG$ function. The activity mode 
indicator of the REG| function is always for this combined function. 
This is because the FETOH$ operation sets the RIR to the base address ■ 
of the subroutine. If the request is successfully completed, the A 
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register will be set to appropriate systems file code. 



Operator: 



FETCHR$A¥0,V1, V3,V4,V5,V6 



where V0 - base address, relative to lower lock, of core area 
where subroutine is to be loaded (also implicit 
starting point of activity) ; 

V1 - name/version of called element; 

V2; - library in which called absolute activity is contained; 
this may be: 

SYSTEM - system library 

JOB- Job library 

■ GROUP/library number - named group library previously 

linked to job; 
V3 - address of data area in core, relative to lower lock; 
V4 - length of data area; 
V5 - data area mode: zero indicates read/write lockin 

will be set to the data area defined by V3 and V4. 

and read will be permitted from any area (B registers 

BU through B7 are set to 17 bit mode) ; 

non-zero indicates use read/write lock of requestors; 

and 
V6 - relative response priority (0-17); if priority not 

specified, priority of requestor is assumed. 



Packet: 



EBJP^B? 




1+11 


! 


Base Address 


N 


. . 


N 




N 


- — 


N 




V 


. . 


V 




Library TaDe 








Library Number (O IF 


NA 


) 




Address 


of 


Data Ar 


ea 


2^^ 


2^8 Y5 


Priority 


Length 


of Data Area 


7 7 5 4. I 




2 1 


6 1 



Note: Base address (VI) V3 and V4. must be a multiple 
of 100 (octal). 






■LOCATE ROUTINE AND READ THE TABLE OF CONTENTS (Function code 22) 

The function is a subset of the FETCH operation. The requested 
routine will be located on the specified library, • The table of 
contents for the element will be retrieved into a 9 word area 
specified by the requestor. 



Operator 



FETCHLl VO, V1, 72" 



where VO - base address, relative to lower lock of a 9 word area 
where the table of. contents is to be placed. 

V1 - name/version of specified element 

V2 - Library in which the named routine is contained, this 
may be: 

SYSTEM - system library 

JOB - job library 

GROUP/library number - a group library linked to ^ob 



Packet 



EBJP^BV 


$+6 




BASE ADDRESS 


N- 


N 


N . 


N 


V -,- 


^v 


LIBRARY TIPS 
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.LOAD SUBROUTINE AND REGISTER AS QUEUE PROCESSED ACTIVITY (Function code 23) 

This function is a combination of the FETGH$ and REGQ$ operators. 
The requested subroutine will be loaded into the specified core area ' 
and then registered as queue processed activity. The user is directed 
to the specifications for the FETCHf and REGQ$ operators for detail. 
For this request, the base address of the FETCH$ function will be the 
same as the starting point of the activity of the REGQ$ function. If 
the request is successfully completed, the A register , will be set 
positive. The A register will be set negative if the subroutine could 
not be loaded. 



Operator: 



FETCHREGQ$AVO, Vi , V2,V3,V4.,V5 



where VO - "base address, relative to lower lock of core area 
where subroutine is to be loaded' (also implicitly 
starting point of activity) j 

V1 - name/version of called element; 

V2 - library in which called absolute activity is contained; 
this may bej 

SYSTEM - system library 
JOB - job library 

GROUP/library number - named group library previously 

linked to job; 
V3 - length of activity; zero implies read/write lock will 

remain set to that of requesting-activity and the activity 
considered an integral part of the compiler requesting 
activity; non-zero length defines the area to be protected 
by memory lock-in arid sets the RIR to the value in VO; 
V4. - five character (octal) identifier used for reference by 

QREF$ operator; and 
V5 - relative response priority (0-17); if priority not 
specified, priority of requestor is assumed. 



Packet: 



EBJP^«& 


$+11 


Base Address 1 


N 


. N 


N 


__, .N 


V 


V 


Library Type 


Library No 


.If Group Lib (0 IF NA) 


Length of 


Activity Identifier 


Priority 


7 7 5 4 


2 16 3 J 



Note: Base Address must be a multiple of 100 (octal) 
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6.8 Cooperative Service Routine C.S.R, 

Library number 007 is a non re-entrant routine used to perform 
service requests for l/O cooperative control and for controlling 
the loading activation and processing of Unit Record Routines. 
The following is a summary of function codes to C.S.R. followed 
by a description of each function containing parameters required, 



Function Code 
01 

02 
; 03 

04 

05 

06 
07 
10 

I I 

12 
13 
U 

15 . 

16 ' 

17 
20 
21 



Operator 
Internal 

CALL§ 
Internal 

Internal 

Internal 

Internal 
Internal 
Internal 

Internal 
Internal 
Unas signed 
Unassigned 
Internal 

Internal 

Internal 

Internal 



Description 

Load and activate primary input 
unit record routine 

Same as 01 ' 

JOB card sensed, set up necessary 

linkage 

Close primary input stream and 
return 

Close primary input stream and 
terminate 

Activate primary output U.R. routine 

Terminate primary output U.R. routine 

Activate secondary output U.R. routine 

T'oiomn r>o + o e Oi itr\v\A o ^/*Tr (-111 + TM1+ TT "R ■r»rtTi + 4 *»d 

Load and activate named edit routine 
Tenninate edit routine 



l/O cooperative library overflow 
possible to occur 

Deallocate overflow mass storage 
extension to I/O cooperative library 

Primary or secpndary output module 
overflow 

Primaiy or secondary output module 
error overflow 
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Function Code 


Operator 


22' 


Internal 


23 


Unassigned 


24 


Unassigned 


25 


Unassigned 


26 


Unassigned 


27 


Unassigned 


30 


Unassigned 


31 


Unassigned 


32 


Unassigned 


33 


Unassigned 



Description 
I/O cooperative module drum error 



Functional description of function codes 

Function code 01 - Load and. activate primary input unit record 
routine indicating scheduling information and limited lata is 
available to be entered into the system and processed. 

Caller; Console Control routine upon receiving an unsolicited 
request from computer operator to begin a scheduling 
pass from a particular device. 

UR P Name/Version (^ 

Type of device is determined -by facility statement 
collected with named unit record routine . 

Parameters: B7=Address of unsolicited call for primary input 
unit record routine. 



# of Char. 



# of Words 



Name 



Name 



Version 



!# of words - allocated by 
console handler from free 
core chain to contain 
operator's message. 

># of characters contained 
in message. 



Addendum: Exec task activity addendum 

Function: -Locate and validate existence of called for unit 
record routine, queue request if insufficient 
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cooperative mass storage. 

•From task addendiim and link to task addendum chain. 
Switch activity addendum and "perform call to pre-selection. 

•Deallocate core used to contain call 

•Form job summary containing call. to unit record 
routines 

Exits: 'If error conditions submit diagnostic message to 
console operator and exit to content supervisor 
via XX function code. 

•If request queued, exit content supervisor via 
XX function code, 

•Successful, register activity to worker addendum and 
switch to pre-selection F.G, XX via content • 
supervisor. 



Function code 02 - Same as function code 

Caller: Internal call form operating program via CALL packet 

Parameters: B7 = address of CALL packet containing name/version 
of primary unit record routine. 

Call Operator: CALL$ Name/Version 



Packet: 



EBJP^BV i 


1+4 


i 


Name 


Name 


Version 


7 7 5 A 2 


3 4 


2 



Addendum: Operating worker task/activity addendum 

Function: 'Locate and validate existance of called for unit 
record routine, queue request if insufficient 
cooperative mass storage. 

"Form task addendum and link to task addendum chain. 
Register activity and perform call to pre-selection. 
Set completion status code 00 in A register of caller.. 

•Form job summary containing call for unit record routine 
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Exits: •Return to requestor 



"A" register = 0000000000 Call completed 

"A", register = 777774-0006 Routine could not be located 

"A" register = 77777ii0001 Invalid unit record routine 

•Register call to pre-selection FC 01 under new 
task/activity. 



Function code 03 - signaling the start of a primary input control 
stream 

Caller: primary input unit record routine upon sensing 
a job card 

Parameters: B7 set to the address of a completed module 

description block. (See ifigure ) describing 
a completed primary input module in which the 
JOB card is the first item. 

Addendum: Operating worker task/activity addendum 

Function: 'Allocate drum modules and store submitted primary 
input module in l/O cooperative library,, 

•Set up primary input chain 

•Register call for pre-selection to activate 
schedule sequence. 

Exit: 'Return to requestor upon successful completion 
"A" registers 00 



Function code 04- and 05 

Caller: Primary input unit record routine requesting the 
close of current control stream and return of 
control under new task addendum (04-) or the termina=* 
tion of routine (05) . 

Addendum: Operating under control of worker task/activity 
addendum. 

Parameters: Last storage module and description packet. If 
incomplete, module item count must reflect # of 
items contained in B7 set to address of 
description packet. 

Function: -Close primary input stream and store last module 
if stream was stored, 

•POP any outstanding requests for primary input on 
this stream. 

6.8-4 



Exit: 



•If function code O4 form new task addendum, link 
UGB and activity addendum. 

•If function code 05 deallocate facility assignment 
ZA, core storage of U.R. 

Function code 04. Return control to requestor 

Function code 05 RETURN exit through content supervisor 



Function Code 06 - Load and activate primary output U.R. routine 

Galleri •Termination due to one of the following: al 

tasks within the job stream have been completed. 
Task has terminated and cooperative library contains 
excessive primary output for task. 

•Cooperative service routine due to excessive primary 
output accumulated for task as signaled by I/O 
cooperative control calling G.S.R. via Function code 20, 

Addendum: Operating worker task/activity addendum 

Function: 'Retrieve job summary and locate called for unit 
record routine. 

•Form l/O cooperative module containing CALL 
card as first item and job identification as 
second item and link to head of primary output 
stream. 



Exit: 



Pre-selection to form selection summary for unit 
record routine* 



Function Code 07 - terminate primary output unit record routine. 

Caller: Primary output unit record routine upon sensing 
on E.O.F. from l/O cooperative control. 

Addendum: Operating worker task/activity addendum 

Function! 'Request cooperative control to close primary output 
stream. 

•If non-standard output routine release core and 
facility assignment. 

•If standard output routine; search for call of 
a standard U.R. output routine. If find made, 
switch control to new task addendum, repeat step 2 
Function code 06 and register U.R. for reactivation. 



Exit: 



Call termination 
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Function code 10 - Load and activate secondary o-atput U.K. routine 

Caller: •"Termination" due to one of the following: All tasks 
within the job stream have been completed. Task has 
terminated and cooperative library contains excessive 
secondary output for task. 

•"Cooperative service routine" due to excessive secondary 
output accumulated for task as signaled by cooperative 
control calling C.S.R. via Function code 20, 

Addendum: Operating worker ■ task/activity addendum 

Function:' -Retrieve job summary and located called for unit 
record routine. Set call bit in "Job Stuck" for 
secondary output. 

•Form cooperative drum module containing call card as 
first item and identification as second item and link 
to head of secondary output chain. 



Exit! 



Pre-selection to form selection summary for unit 
record routine. 



Function code 11 - Terminate secondary output unit record routine. 

Caller: Secondary output unit record routine upon sensing an 
end-of -stream status from cooperative control. 

Addendum: Operating worker task/activity addendum. 

Function: •Request cooperative control to close output stream. 

•If non-standard unit record routine release core and 
facility assignment and exit by normal return mechanism, 

•If standard output routine; search for call of a 
standard secondary output unit record routine. If find 
made switch control to new task addendum, repeat step 2 
of C.S.R. Function code 10, reset storage module to 
restart unit record. If no find made, deallocate core 
and facility. 

Exit: Call termination via normal RETURN through content 
supervisor. 

Function code 1 6 - Allocate additional mass storage for l/O 
cooperative library and form bit map for acquired mass storage. 

Caller: •Systems initialization to effect allocation of base 
map overflow. 
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•From C.S.R. as the result of processing Function code 20 
of C.S.R, 

Parameters: None 

Addendum: Worker task/activity addendum . 

Function: "If maximum number of additional extensions to 

cooperative library has not been obtained submit 
the following facility request statements through 
the normal facility assignment routine. 

ASG$^^AI/0 LIB, ZD, 950^0D/1 90080D 

where - lOLIB is type of random access storage 

required to satisfy request as determined 
at time of "facility map" forrr.ation; 
Preferably lOLIB should be equaled to 
medium grade mass storage FH880. 

ZD indicates cooperative, library file code 

950/iOD/l 90080D are the minimum/maximum 
number of words used on extension requests. 
I9OO8OD words will provide 96O modules and 
use up a -^ ' ic posioion u1.k> map* 

•Allocate core and form a 37g position bit map setting 
end bit position to reflect lock of maximum allocation 
from facility assignment* 190,080 words of mass 
storage provides 960 modules at 198 words. 

Adjust module counters and link to "Bit map descriptors" 
&ee 7. 4.. 2) 

Exit; Return to requestor "A" set if allocation 

successful. "A" set 7777740006 indicating mass 
storage unavailable. 



Function Code 17 - Deallocate an unused mass storage extension 
to cooperative library. 

Caller: "Cooperative Control" when it has detected all 

storage modules within a particular bit map have 
been released. 

Par amet ers : None 

Addendum: Task/activity addendum of program causing release 
of last module. 
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Function: .Check for any activities which were pushed on "C.S.R. " 
chain cell due to overflow of a stream or a primary 
input U.R. routine which was not activated due to lack 
of mass storage. If either is found ready its lost 
control and re-enter point, "pop^' request and exit to 
original caller, 

•Check last bit map in chain of bit maps (extensions) is 
empty. If so, deallocate mass storage extension, release 
bit map. core and repeat this step. If last bit map 
is not empty exit to caller. 

Exit J Control is always returned to call or with successful 
completion status code "A" register = 0. 



Function code 20 - a call to indicate one of the primary or secondary 
output streams has reached the maximum number of modules which can 
"be contained on the cooperative library at any one point in time. 
This number is set by systems convention. 



Caller: 



Cooperative control upon sensing overflow. 



Parameters: B2 register set "0" or "1" indicating which stream 
primary or secondary respectively has overflowed . 

Addenduja: Task/activity addendum of program causing overflow. 

Function: Perform the following sequence of checks. 

a) Read "Job Stack" and check to see if unit record 
routine has been called for. If so, skip to step C. 

b) "REGCT" call for C.S.R. function code 06 or 10 to 
call primary or secondary output routine. 

c) Execute C.S.R. subroutine used process Function cqde 16 
to obtain additional mass storage. If additional 

mass storage is obtained return control to requestor. 
If additional mass storage is not obtained "PUSH" request 
of content supervisor chain for lock of mass storage 
return to requestor as next function to perform' on 
subsequent "POP".' 

Exit: Return program control to cooperative control if 

additional mass storage can be obtained, otherwise 
PUSH activity until unit record is activated. 
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6.9 Pre-Select 

The function of pre-selection is to obtain explicit and implied 
scheduling parameters which have been presented to the system 
by the control Inaguage, from a pass through the lader or are 
registered in the systems library. The scheduling parameters 
are summarized for use by selection. All control statements 
required task/activity are readied for GCI phase, 

Pre-selection is activated by the following function codes 

Function Code Operator Description 

01 Internal 



02 

03 

04 

05 

06 
07-33 



Internal 
Internal 
Internal 
Internal 

Internal 
Unas signed 



Pre-s elect primary input unit 
record routine 

Pre-iselect next task contained 
in control stream 

Pre-select primary output unit 
record routine 

Pre-select secondary output unit 
record routine 

Pre=select edit routine for 
primary input 

Control card interpreter 
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Functional Description of Function Codes 

Function code 1, 3j Uj 5: Ready call for unit record routine for 

selection and initiation. 

Requestor: Cooperative Service Routine upon validating a 

call for the load and activation of a U.R. routine. 

Exits: Release Pre-selection and queue a call for 
Selection under exec addendum. 

Addendum: Operating worker task/activity addendum 

Processing: a. Find the Job Description through the 
Procedure appropriate entry in the JOB Stack. 

b. Locate the appropriate control statement 
within the Job Description. 

c. Locate the specified routine on the library, 

d. Preprocess and form si,ummaries for any 
control statenlent attached to absolute 
element. 

s. Update the Job Dsscription smd the Job Stack, 



Parameters: FC 1 



FC 1 


EXRNi^20A01 J 






FC 3 


EXRN^204.03 






FC 4. 


EXRN^20-d.0-d. 






FC 5 


EXRNtt20^05 



Function code 2: Ready a task for selection and initiation 

Requestor: Cooperative Service Routine upon sense of a 

job statement or by Termination for selection 
of next task in job already started. 



Exits: 



Release Pre-selection and queue a call for 
Selection under the exec addendum. 



Processing 
Procedure • 



a,, Request an image from cooperative control, 

b. If JOB cards set up Job Stack, Job 
Description 
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c. Pre-process all control statements through 
the task execution statement building the 
summaries . 

d. Locate the specified element on the library 
and pre-process any control statements 
associated with the absolute element. 

e. Set up load function in summary 

f. Update job stack bit settings 

Function Code 6 - interpret the control statement and transfer 
control to routine responsible for processing the control statement. 

Requestors Any worker program requesting the -processing of a 
control statement within his primary input stream. 

Exits: 'Release control card interpreter and transfer 
control to processing routine. (DRET1$ B1 = 1 
B2 = processing routine) , 

•Release control card interpreter and return control 
to requestor (DRET1| B1 = O) 

Addendum; Requestor task/activity addendum. 

Processing 

Procedure: a) Examine control statement operator.' 

b) ' Search' list of acceptable functions. 

cj Set up switch to processing routine if not 
processed by CGI, 

Switch to processing routine. 

If processing is responsibility of CGI process 
and return control to requestor. 

Parameters: B7 = address of control statement (^OD) 

Q = length of control statement (SMOD) 
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6.10 Selection 



The function of selection is to determine which task or activity 
from the current pre-selected candidates shall- be introduced into 
the mix of active programs based on selection priority and available 
facilities. Once an element has been selected it will be allocated 
and activated by serial executing control statements as formed by 
pre-selection. 

Selection is composed of two phases; Select phase and control: 
card interpretation phase (C.C.I.). Activation of selection is 
by the following function codes: 



Description 

Select task or activity from 
current stack. 



Function 
Code 


Operator 


01 


Internal 


02-Oi; 


Unas signed 


05 


Internal 


06-33 


Unassigned 



Initiate selected activity/task 
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Function Description of Function Codes 

Function Code 1: Select a task or an activity from the Job 
Stack for activation. 



Requestors 
Exits: 



Addendum; 

Processing 
Procedure j 



Pre-selection 

•If a task is selected establish an activity 
addendum and storage module or worker addendum 
requesting the Initiation phase of Selection, 
and return to the Content Supervisor requesting 
a return to the exec switches releasing selection. 

•If no task selected return to Content Supervisor 
requesting a release of selection and return to 
exec switches. 

Exec task/activity addendum. 



a. Deallocate addendums of inactive tasks 
placing addendums and held U.C.B. in 
selection cooperative bit map storage. 

b. Summarize peripherals available on system. 

c. Go through priority chain in the Job Stack 
selecting a job or appropriate task, 

d. Establish worker addendums in core and 
switch to worker addendum issuing a request 
for the Initiation phase. 



Parameter: 



FC 1 1 EXRN^aOUl 



Function Code 5: Initiate the task selected. 
Requestor: Selection 
Exits: Queue request for Selection under exec addendum. 



Processing 
Procedure: 



a. Process the control statements contained in 
Pre-selection control statement summary using 
the Control Card Interpreter, 

b. Load absolute element and modify to running 
form, " . 

c. Queue a request to start the routine, 
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Parameters FC 5 I ENT^Q^WCVO) 

I EXRN^20U5 



Y) = the address at which the map number 
and start position of the control • 
statement summary. 
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All 



Termination (library number 10) is a non re-entrant ..routine responsible 
for the removal of a task or activity from the system along with 
its core and peripherals which are not to be held from one task 
to another. It is activated upon the issue of a RETURN operation 
by a routine with no outstanding activities or upon the ABORT or 
ERROR exit of some routine. 



Functions? Function 

Code Operator 



01 



02 



03 



Internal 



abort! 



ERRORl 



Description 

A task/activity issues a 
RETURN with no outstanding , 
activities. Deallocate the . 
appropriate task/activity. 

A task/activity signals the 
abortion of the job from the 
system, 

A task has indicated that 
termination is desired because 
of error conditions. 



05 



Internal 



xj^a.^jLKj\i<xuc Olio opcuxx. 

record routine. 

A task/activity has encoiintered 
a fault condition. Abort the 
job from the system. 



Functional Description of Function Codes 



Function Code 01 - A task has completed all functions implying 

the deallocation of all core and non-held 
peripherals. The activation of termination 
was initiated by the basic exec when a RETURN 
was issued by the routine with no outstanding 
activities to which control can be given. This 
is the normal task termination procedure. 

Caller: Basic Exec, Return Mechanism 

Parameters: Entrance is made by a REGCT ' function. .No 
additional parameter is required. 
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Addendum: Worker Task/Activity Addendum 

Function: a) Release core assigned to task. 

b) Release all non-held peripheral of task. 

c) Throw away non-control statements for task 
down to first control statement. 

d) Log all pertinent information for core, peripheral 
in the Job Description module. 

e) If the end of the control stream has been 
reached, deallocate all facilities, deallocate 
primary input U.R. routine if not already done, 
clear job library of entries for this job, 

clear all mass storage locks, console queues, etc* 

f) Get accounting information from Job Description 
and submit to primary output. 

g) Close out primary and secondary output streams, 
h) If primary output not pre-selected, make return 

to GSR requesting activation of primary output 

unit record routine, 
i) If secondary output not pre-selected and active, 

make return to GSR requesting activation of 

secondary unit record routine, 
j) If output routines active, abort control thread 

and wait for reactivation through a request for 

unit routine deallocation, 
k) If all activities are complete, switch control 

thread to exec addendum with re-entry to 

deallocate task and activity addendum of job. 
l) Make a switch to selection for the selection of 

another task. 



Exits: 



1 . ABCT, to wait for unit record routine completion. 



4-V.^^ V, P C 






activation of unit record routine. 
3» SWITGT -and DRET$1 requesting the deallocation 
of the task and activity addendums* 



Function Gode 02 - A task/activity requests the removal of the 

entire job from the system. 

Galler: Worker Routine Via Exec 

Addendum: Worker Task/Activity Addendum 

Function: a) Release core, 

b) Throw away all primary input 

c) Release all facilities. 

d) Delete Job library using L.S.R. function code 2 

e) Glear mass storage locks, etc. 

f ) Put out task accouting information and abort 
exit condition. 

g) Put out job accounting information on P.O. 
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Exits: 



h) Gloss out P.O. and S.O., set termination 

indication, 
i) Put out P.O. and S.O. 

j) Release output unit record routine facilities, 
k) Log all job accounting information. 
1) Switch central thread and go to selection for 

deallocation of addendums. 

DRET1$ B1=1 B2=CSR to GSR for pre-selection 
of outpat unit record routines, 

ABCT, for deallocation of control thread when 
unit record routines still active. 

SWGT and DRET$ for deallocation of addendums. 



Function Gode 03 ^ A task/activity has indicated on termination 

of the current task is necessary because of 
an error condition. 

Galler: Worker Routine Via Exec 

Addendum: Worker Task/Activity Addendum 

Function: Essentially the same as Function Cod© 1 

Exits: Same as Function Gode 1 

Function Gode 04 - Deallocate and release facilities of unit 

record routine. 

Galler: Gooperative Service Routine 

Addendum: Worker Task/Activity Addendum 

Function: a) Release core and facilities of unit record 
routine, 
b) If task is in process of termination check 
completions of all functions. 

Exits: SWGT ■ to Exec 

. DRET1$ B1=1 B2=Selection 



L 11 
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6.13 Library Maintenance Service Request 

Library munber 006 is a non-reentrant routine used to enter an element 
in the Job Library and to delete elements or portions of elements 
already in the Job Library. The following is a summary of function 
codes to Library Maintenance Service Request followed by a description 
of each function containing parameters required, caller, addendum, 
exits, and test conditions. 



Function 




Code 


Operator 


01 


Internal 


02 


Delete 



03 



Internal 



Description 

Enter element in Job Library. 

Delete specified elements from 
the Job Library. 

Delete all elements associated 
with the current job from the 
Job Library. 



Functional Description of Function Codes 

Function Code 01 - Enter an element in the Job Library. 



Caller; 
Parameters; 



Addendum: 
Function; 



Exit: 



Processor (SPURT, COBOL, etc.) 

B4. = Address of storage module causing activation 
biased by lower lock limit. 

B7 (in storage module) = Address of processor 
output TOC. 

A Rep'ister = Job number of elsment 

A Register (in storage module) = File code of 
element. 

Worker task/activity addendum 

. Create Internal TOC for element and enter it 
in TOC module chain. 

. Perform all necessary updating of Job Directory, 
Bit l-lap, and TOC Module. 

. Transfer element from mass storage to the Job 
Library. 

* Retm^n control to content supervisor upon 
completion. 
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Function Code 02 - Delete specified elements from the Job 



Caller: 



Parameters: 



Addendum: 
Function: 



Exit: 



Library. 

# Delete statement through the primary- 
input stream. 

B4 = Address of storage module initiating 
activity biased by- lower lock limits. 

'B7 = Address to the control statement causing 
activation. 

Worker task/activity addendum 

The purpose is to release prime mass storage 
back to library maintenance or to the system.' 
The effected elements are specified on the 
delete statement in the following format: 

# DELETE option NAME/VERSION, ETC. 

If the (V) option is used , the name/version 
are interpreted as group library names. The 
group library is an extension of the job 
library. To release this area of storage 
the function issues a "FEIEE" statement to the 
system. Then, the associated library links 
are removed from the job directory. If no 
option is present, the elements are interpreted 
as resident on the job library. The element's • 
area of storage is released to library 
maintenance and the element's associated TOG 
is deleted. 

Direct return. to requestor. 
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Function Code 03 r Delete all elements associated with the current job. 
Caller: 



Parameters: 
Addendum: 



Exit: 



(a) register = Job Number 

Worker task/activity 

The purpose is to return all storage associated to a 
Job back to maintenance or to the system. The job 
directory is searched for job and group library links. 
The links, TOGS, and element area are delete from 
master storage directory. If a group library is assoc« 
iated to a job, storage is returned to system through, 
a "FREE" statement. Next, the links and job number 
is removed from directory. 

Direct return to requestor. 
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6.13*1 Processor Interface 

All processors operating under the control of OMEGA 
utilize OMEGA services and functions in the performance 
of their duties. An explanation of some of the services 
provided and the method of employing these services 
follows, 

•Control Statement Access 

In the process of loading and initiating a processor the 
control statement resulting in the call of the processor 
is removed from the input control stream. Since all 
processors read the statement to interpret data contained 
therein, this card is placed on mass storage via the 
SENDP$ operation. The individual processor must issue ■ 
a corresponding REGIEVEP$ operation in order to obtain this 
statement. (See Secondary Exec documentation) 

•Register Settings 

When the individual processor is given control the A 
register will contain the job number for which the 
processor is performing its task. RIR is set to the 
processors base. The lock limits are set to include 

A.-L.^ -^_^ -~^_ l^^;!^w.»J 4-^ 4-1..^ «v^^^.^,««^^ Tins 4 m «#n4. 4-^ 
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15 bit B registers. 

•Available Services 

All OMEGA service available to a worker routine are 
available to the processor. 

•Option Interpretation 

The following is a list of options applicable to individual 
processors, their meaning and action to be taken because 
of the option ' s presence ; 

Options - Y = Accept the results of the processing 
as correct even though errors were 
detected. The processor would put 
out an element marked as error free, 
even though some non-critical error (s) 
were present. If a critical error 
occurs which will inhibit the validity 
of the output, the Y option is ignored 
and the element marked as being in error. 
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X = Abort the remainder of the job if any errors 
are detected by the processor. If 'neither 
a X or Y option is present and errors are 
detected, the job will continue, but any 
attempt to collect and execute the routine 
• will be inhibited unless options are provided • 
on the LOAD and GO statements verifying the 
validity of the element. 

Even though an abort eonditon occurs the 
processing will continue in the respect that 
any listing output will be obtained if possible. 
No output other than the listing will be 
produced on the abort condition. The processor 
will issue an ABORTS function which will 
cause CMEGA to abort the entire job with all 
incompleted tasks being aborted also. 

Z = Error out the task if an- error occurs during 
processing. Any listing requested will be 
completed, although no element will be produced 
by the processor. This causes the termination 
. of the current task, but will result in the 
processing of tasks within the job stream. 

The processor will issue an ERRORS to initiate 
this action. 

L = Produce a complete listing of the routine 

being processed. The listing will consist of 
all pertinent data. Any summarization and 
error listing will also be given. 

N = Supress the source and object code listing 
implied by an L option. No information will 
be printed except for certain error diagnostics. 

S = Produce a list of, symbol definitions which 
can be used by the diagnostic routine. These 
symbols will consist of mnemonic source labels 
within the routine being processed along the 
relative position of the label. 
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•Error Indication 

The error indicator in the lower half of the first word of 
the toe is set to indicate the status of the element processed. 
Subsequent processors of this element will be influenced by 
this error indicator along with the processor options as to 
the action to be taken when an element marked as containing 
an error is encountered. 

The error indicator is broken down into a series of lists, 
each of which implies a categary of error(s) which occured 
during the production of the element. 

A breakdown of the categories of errors possible and the 
fields assigned to individual processors concerned with the 
manipulation of elements. If an error condition is encountered 
the processing will set the bit in its assigned field which 
defines the category in which the error falls and the 
corresponding bit in the general field. 



J2U jO 2^2 2^1 2i0 29 2^2^ 2^ 2^ 2^ 2^ 2^ 2^ 2^ 



ERROR 
* INDICATOR 



General - General error setting used by all processors 

2^ - If set indicates a critical type of error 
occurred which makes the validity of the 
element improbable, (e.g. overflow of 
available storage, loss of data, etc.) 

2 - If set indicates a generative type error which 
will probably interfere with the collection 
or execution of the element. 

12 
. 2 - If set indicates a generative or declarative 

type error which may or may not interfere with 

the further processing of the element. 

Compiler - Error settlings reserved for error conditions encountered 
during the compilation of the element by the 
processor (COBOL, FORTRAN, etc.) 

2^1 . 29 

Assembler - Error setting reserved for error conditions 

encountered during the assembly of the element. 

28 - 26 

Loader - Error settings reserved for error conditions 
encountered during the collection of elements. 

2^ - 2^ 
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Library Maintenance - Error setting reserved for errors 

encountered upon the manipulation of 
the element by the library maintenance 
routines . 

22-2° 



•Service Request 

The Library Service Routine serves as the means by which an element 
produced by some processor may be entered into the job library 
complex, from which it may be operated on or used by other systems 
or user programs. 

The Library Service Routine (LSR) is used to transfer three different 
types of elements (RB, ABSOLUTE, SOURCE). The description of 
the TOG header necessary for LSR to process the element may be 
found in Figure 1 of this section. 

The linkage provided by the processor to the LSR is defined below. 



ENT^B7^T0C ADDR 
ENT^A*FILE CODE 
EXRN»LSR1 



LRS1 EQUALS*20601 



where TOG ADDR - the base address of the toe which defines 

the element to be entered into the job library, 

FILE GODE - the file code under which the element to be 
entered into the job library may be found. 

After the transfer of the element from the specified file to the 
job library has been completed the requesting processor will be 
given control at the address following the request for LSR. 



'Termination 

The normal method or the termination of any task/activity is 

the issuance of a RETURN$ ' function with no outstanding activities 

to be completed. 

If the options imply an error exit upon sensing an error this is 
accomplished by the issuing of the following function. No control 
is returned to the requestor, 

ERROR$ 

If the options imply an abort condition is called for, this can be 
accomplished by the issuing of the following function. No control 
returned to the requestor, 

ABORTS 
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ErrERNAL TOO FOBMATS (PROCESSOR OUTPUT) 



RB 



1' 



N N 
N N 
V V 
Increment 



Error Ind 



1 N 

N N 
V V 
to EDEF 



N 
N 
V 



Increment 

Increment 

Increment 

Increment 

Increment 
Length of 



# of EDEF 
to XPJ)F 

# of XREF 
to CC 

# of GC 
to 11^0 

# INFO 
to SDEF 

# SDEF 
to TEXT 
TEXT 



This toe is produced by the assemblies 
and compilers. It contains a description 
of where the individual parts of the element 
are on the scratch file of the processor. 
Before termination a processor will make a 
service request calling for library 
maintenance which will in t\irn place the 
element in the job library. 



ABS 


2 


Error Ind 




N N 


N N N 




N N 


N N N 




V V 


V Y V 




Increment 


to ASG Images 




Max Core Us 


ed # Images 




Increment 


to ELT Base 




Length 


of ELT 




. Increment 


to SDEF 

# SDEFS 




# Segments Length of 

Control 



SOURCE 



Error Ind 



N -N 
N N 
V V 

Increment 
Sub Type 

Element 



N N N 
N N N 
V V V 
to ELT 

# Images 
Length 



The absolute toe is produced by the 
collector-loader. The proceedure for 
handling is similar to that for an RB 
toe in that an internal service request 
is made for library maintenance. 



The source toe could be produced by 
any processor. Usually it would be concerned 
with central card images. A sub type is 
provided whereby the source code could be 
indicated as compressed. The element length 
is required iji case the sub type indicated 
compressed > otherwise 20 word images are 
assumed. 
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6,30.1 Selection Job Stack 




1 
2 
3 
4 

6 
7 
10 
11 
12 
13 



LARGEST JOB # 



# JOBS IN MODULE 



INCREMENT TO NEXT JOB STACK 



INCREMENT TO BIT MAP MODULE 



BASE PRIORITY LINK 



BIT SETTINGS 



SELECT PRIORITY 



PRIORITY LINK 



INCREMENT TO JOB DESC. MODULE 



MINIMUM CORE 



LENGTH TASK SUMMARY 



MAXIMUM CORE 



MAP # I START POSITION 



JOB ENTRY 1 



JOB ENTRY 2 
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oexection job otack description 

•General Description 

The selection job stack is maintained in the l/O cooperatives mass 
storage file, A link to the base job stack module is maintained 
in the 5th word of the core summary map. 

A job number and a cell within the job stack will be assigned by 
the cooperative service routine when a job card is sensed in the 
input stream. Although each job cell in the job stack contains 
the job number, the job number can be calculated by the position 
of the cell within the module or subsequent modules. Each module 
is capable of hold 4-0^ job cells. "* 

After the cooperative service routine has set up the. job cell in 
the job stack, along with the establishment of a task addendum, an 
entry is made to the preselection phase of selection. 

Preselection will examine all control statements in the input stream, 
.through the first control statement resulting in an execution 
request. In examining these control statements preselection will 
set up a facility summary consisting of all facilities requested 
in the control stream and by the routine to be executed. This 
summary is preserved in a storage module on the cooperative mass 

Storage llle. it WXll De uooa ujr ooxouuxuxi xu uouoniLLaj.xigXJ.uuo 

job can be loaded and executed within the mix of jobs in the system.' 
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'Detailed Description 

Word. iZf - U = The largest job number that has been assigned. 

L = The current niimber of .job entries in this particular 
job stack. The maximum is 60 octal for any one 
stack module. / 

Word 1 = A link to the next module of th!e job stack if one • 
is present. Subsequent modules will have the same 
format of the initial one except for the sign bit 
of word 0. 

•* ' • 
Word 2 = A link to a module used for storage of bit 'maps 
describing areas taken up by selection summaries • 

Word 3 = Base link to job of highest priority , 

Word 6 = The start of a job entry. The bit settings indicate 
the status of the job at any one time. 

Bit Settings ' Meaning 

2^^. JOB terminated, clear from system 

2^8 End of control stream reached 

o27 

226 

2^5 

224 

223 

.222 . 

221 

220 . 

2l9 
2^8 

2-^7 . 
216 

2^5 
2H, 

213 

2^2 

2II f 

2IO 

29 

28 

27 
20 

25 

2A Task rolled out 

^3 " active 

22 " initiated 

2^ " selected 

2^ " preselected ■ 
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Primary 


input 


called 




It 


It 


preselected 




n 


It 


selected 




II 


II 


initiated and active 


Primary 


output called 




II 


II 


preselected 




n 


II 


selected 




II 


It 


initiated and active 


Secondary output, called 




It 


11 


. preselected 


, 


ft 


II 


selected 




It 


II 


initiated and 


active 


Edit Routine 


called 




II 


II 


preselected 




It 


ti 


selected ' 




It 


ft 


initiated and 


active 



Word 7 - U = The select priority which is assigned according to 
the following conditions. 

a. Priority specified by user. 

b. The number of tasks within the job that have 
been completed. 

c. The amount of primary input 

d. The number of peripherals required by the task.. 

e. The number of times a task has been passed upi^ 

- L = The job number assigned by the dooperative service 

routine. 

Word 10 = The increment to the job description module on the 
cooperative library file (ZD), 

Word 11 '- U = The minimum amount of core the task can use if it 
is available . 

- L = The maximum amount of core the task can use if it 

is available. 

Word 12 - U = The length of the initial task summary. 

- T. =: lA-nV +.o •^n'h r>f*. 1-10^+. Vi-^ crhA«+. ■D''*iQ'''itV 

2H«2" = The. map number which defines the base storage module 
used for summary storage. 

2^-20 = The bit position defining the base sub cell used 
within the storage module. 



.6.30-4 



6.30.2 Job Description Module 



HEADER 



I INCREMENT TO NEXT JOB. DESG. MODULE OR TO ITSELF 
1 



L t 



MODULE LENGTH 



INDEX TO NEXT AVAIL. LOG. 



FILE INGREMENT TO CURRENT MODULE 



LENGTH TASK ADDM & UGB 



LENGTH CONSTANT AGGT. INTO 



MAP # AND START 



INDEX TO CONSTANT AGGT INFO 



FILE INGREMENT TO MODULE WITH CONST. AGGT. INFO 



T Tn\TP-TU TnT5 T"nTrAT~TTr~n A TTH^T 



!l^TDEX TO JOB I.D. 



FILE INGREMENT TO MODULE WITH JOB I.D. 



LENGTH PRIMARY INPUT U.R. INFO [INDEX TO P.I.U.R. INFO 



FILE INGREMENT TO MODULE WITH P.I.U.R. INFO 



LENGTH PRIMARY OUTPUT U.P. INFO INDEX TO P.O. U.R. INFO 



FILE INCREMENT TO- MODULE WITH P.O. U.R. INFO 



LENGTH SECONDARY OUTPUT U.R. INFO INDEX TO S.Q.U.R. 



FILE INCREMENT TO MODULE WITH S.O.U.R. INFO 



LENGTH EDIT ROUTINE INTO 



INDEX TO EDIT ROUTINE INFO 



FILE INCREMENT TO MODULE WITH EDIT INFO 



LENGTH OTHER ROUTINE INFO 



INDEX TO OTHER ROUTINE INFO 



FILE INCREMENT TO MODULE WITH OTHER INFO 



LENGTH ACCOUTING INFO 



INDEX TO ACCOUTING INFO 



FILE INCREMENT TO MODULE WITH ACCOUNT INFO 



LENGTH DUMP INFO 



INDEX TO DUMP INFO 



FILE INCREMENT TO MODULE WITH DUMP INFO 



LiiiNGTH CHANNiiiL NUMMARY 



llNUliiA TU unANNiiiL ^ summaki 



FILE INGREMENT TO MODULE WITH CHANNEL gf SUMMARY 



LENGTH CHANNEL 23 SUI^IARY 



INDEX TO CHANNEL' 23 SUMMARY 



T?TTir TATPPTTTWCAFP fPO 'MnnnT TT T.TTfPU PUAMWTPT .0*3 QTmMABV 
A' j..tjxj ^xnwxta^u'j-LJXiix x\j A'j.'>/.L/ u xjxj nj.xix vyixjixixixjx^ t^^ w»»L>*'.a-MJ.*.j. . 
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P.I.U.R 



P.Q.U.R 



S.O.U.R 



JOB I.D. A 1 JOB ID ENTIFICATION 



B 



D 



EDIT R. E 



(JOB STATEMENT 


FROM INPUT 


STREM) 




LENGTH INPUT U.K. 


SUMMARY 




MAP 4 & START OF INPUT U.R. 


PRIMARY INPUT UNIT RECORD ROUTINE , 



CALL CONTROL INFORMATION 



LENGTH PRIMARY OUTPUT U.R. SUMMARY MAP # & START OF P. OUTPUT U.R, 
PRIMARY OUTPUT UNIT RECORD 







ROUTINE CALL CONTROL INFORMATION 


LENGTH SEC. OUTPUT U.R. SUMMARY 


MAP # & START OF S. OUTPUT U.R. 


SECONDARY OUTPUT UNIT RECORD 

f— „ 





ROUTINE CALL CONTROL INFORMATION 



LENGTH EDIT SUMMARY 



MAP & START OF EDIT 



EDIT ROUTINE CONTROL 



STATEMENT INFORMATION 
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OTHER R. 



GONSTMT ACGT, 



CHMML SUMMRI 



F LENGTH OTHER SUMARI 



MAP # & START OTHER 



OTHER ROUTINE CALL 




GO 

1 

2 
3 

5 



CONTROL INFORMATION 



DATE OF JOB ENTRANCE 



TIME OF JOB ENTRANCE 



HR: 



MN: 



SEC 



TOTAL CP UNITS USED BY JOB 



AMOUNT PEL INPUT 



AMOUNT PRE OUTPUT 



AMOUNT SEC. OUTPUT 



10 



HO 

1 

2 
3 
4. 
5 



DATE OF TASK SELECTION 



TIME OF TASK SELECTION 



HR: MNs 



SEC 




P-TIPE 



TOTAL STORAGE OR # UNITS ASSIGNED 



TOTAL TIME PERIPHERAL HELD 



TIME OF LAST ASSIQ5MENT 



HR: MN: 



SEC 



AMOUNT OR # UNITS LAST ASSIGNMENT 
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Job Description Module 



•General Description 

The job description module is linked off the job stack entry for a 
particular job. Each job has a separate job description module or 
chain of modules. The storage for the modules is obtained form the 
cooperative library file (ZD), The job description module contains 
unit record routine descriptions, job identification, and accounting 
information associated with the job. The module is originally 
produced by the cooperative service routine upon processing a JOB 
control statement. Entries and modifications to the module are 
made during preselection, selection, facility assignment, 'facility 
release, and termination. 
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•Detailed Description 

Word Increment to the next job description module in the . 

chain. If only one module exists the link is to 
itself. Each module in the chain has a link as the 
first word of the module, 

1 U The length of the l/O cooperative module being used. 

Normally this is 306g, 

L The index relative to the base of the module currently 
being used for deposit of information. 

2 The file increment to the module currently being used 

for deposit. ■' 

3 n The length of the task addendum and unit control 

block stored, 

L The map number and start position of the storage used 
for the task addendum. See ( ) for function of 
bit map storage facility. 

4,-64 Each two word entry in the rest of the header defines 
the location of some information. The upper defines 
the length of the data, the lower defines to index 
relative to the base of the module containing the 
information. The second word gives the file increment 
to the module containing the information. This increment 
may be to the same module containing the header 
information. 

A The job identification normally consists of the job 
control statement from the primary input stream. 

B The primary unit record routine information consists 
of a link through the selection list map to a 
summarization of the unit record routine requirements 
for facilities, core, etc. The control statement calling 
for an input unit record follows the summary link 
The summary link is provided by preselection. The 
control statement is added by the cooperative service 
routine for processing' by preselection. , 

C Same as B except for primary output unit record routine. 

D Same as B except for secondary output unit, record routine. 

E Sam6 as B except for the edit routine. 
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F Same as B except for other routines. 

Go The date upon which the job was enetered into the system, 
1-2 The time in. hours, minutes, and seconds which the 
job was entered into the system, 
3 . The total central processor time units (200us) used 

by the job. This is a ciMulative total for the whole 
jo^- 
4-^ The number of cooperative modules ued for the primary 
input, 
-L The number of cooperative modules used for primary 
output. 
5 - U The number of cooperative modules used for secondary 
output , 

- L Spare 

• 6 The date upon which the current task was selected, 
7-10 The time in hours, minutes, seconds at which the task 
was selected. 

Ho -U The peripheral type of the units on this channel. 

- L Unassigned 

1 The total storage or number of units assigned during 
the job. 

2 The cumulative time that the peripheral was held. 
' 3-4' The time at which the last assignment was made,"' 

5 The amount of storage or the number of units assigned. 
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6.3.0.3 PBESl¥. MODULE 





1 

2 
3 
U 
5 
6 
7 
10 



LINK NEXT MODULE 



# WORDS 



PERIPHERAL NME 



# UNITS 
REQ UI R ED 



MASS STORAGE REQUIRED 



# ENTRIES 



LENGTH SEL SUMMARY 



P-TYPE 



CHAN 



CHAN 



LMGTH UNIT SUMMARY 



MASTER BIT UNIT 



MASK 



P-TIPE 



CHAN CHAN 



LENGTH UNIT SUM 



0=MS 
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PresTjm Module Description 

The Pres-um Module is the initial module linked off the job stack, or the 
job description in the case of a unit record or edit routine summarization. 
It contains the information necessary" for the selection routine to determine 
if a routine can be loaded. 

The Presum Module is produced by pre-selection from the Assign statements 
encountered in the job control stream. It is maintained on the cooperative 
library file (ZD), through the bit map module. The storage used by the 
summaries is released back into the bit map once "Uae task has been relisted 
and initiated. 

Word j^ » Link to another module if one is present. The link is broken down 
into a 6 bit start position and a 9 bit map number referring to the 
bit map module. The sign bit is set if the link is to another 
presum module and not set if the link is to the facility summaiy. 

Word 1 = Number of words within the next summary module. 

Word 2 = The start of a summary cell. The name. is a 5 character name of the 
peripheral specified on the Assign statement. 

Word 3 = Bits T^^-Tr^ - the number of individual units requested under the 
peripheral name. 

Bits 2^-2 - the amount of mass storage requested. 
Word 4 = U = the number of channel entries in the channel summary, 
L = length of channel summary for this name. 

Word 5 = 2^*^-220 ~ I'eripheral type 
224—2 = Channel number 
2'! 9.2'' 5 = Channel number 
2 ^-2 = Length of unit summary for this channel. 

Word 6-7= Master bit setting for those units on the channel which would be 
acceptable for assignment. 

Word 10 = Indicator for mass channel. 



Words 2-10 represent a sample entry.' The entries will vary with the different 
peripheral names. All words except for word 2 are obtained from the selection 
facility summary map which is a congestion of the regular facility map. 
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BIT MAP MODULE FOR LINKING SELECHON SOMMARIES 






M0DI3LE LENGTH 




1 


. LINK TO NEXT BIT MAP MODULE 


2 




# USED CELLS 


3 
5 




6 


INC TO STORAGE MODULE 


7- 




# ?HEF. SUB CKT.T.S 


10 


iSITB CKi.T. BIT SETTTNGS 


11 


INC TO STORAGE MODULE 


12 




# FREE SUB Q-EULS 


13 


SUB CELL BIT SETTINGS 






___— 



30A 
305 



STORAGE CELL 1 (MAP #1 ) 



J 



STORAGE GMI,2 (MAP #a) 



6.30-13 



Bit Map Module Description 

• General Description 

Each "bit map module has a 6 word header portion which defines the link to 
the next bit map module if there is any additional modules, and the number 
of free and used storage cells within that module. There is a maximuiii of 
100g storage cells within one module. Each storage cell has a map number 
dictated by its position within the module, for example words 6-10 of the 
initial bit map module would be referred to as storage cell one vdth a 
map number of 1 . 

Each storage cell defines a 306 word module on the cooperative mass storage 
file, which is used for the storage of selection summary data, etc. Each 
of the storage modules have a 2 word header and 204m words of storage which 
group (sub cell) is represented by a bit setting in the third word of a bit 
map storage cell. As a sub cell is filled with data the appropriate bit in 
the bit map storage cell is set to a binary one. 

As the summary information is processed by selection the cells are freed 
for use again. If a complete module is empty it is released back into the 
cooperative pool. 

The bit map module is maintained on the cooperative library file (ZD). 

Word fi = U - The length of the module containing the bit map. 

1 = A link to another bit map module or if no other module exists. 

2 = U - The number storage cells used within this bit map module. 
3-5 = Free 

6 = Is the start of the first storage cell. It contains an increment 
to a storage nodule to be used for storage. The storage module 
to be used for storage. The storage modules are obtained from 
the cooperative library file (ZD). 

7 = The number of free sub cells within the indicated module. Each 
subcell consists of 7 words. 

10 = A series of bit setting representing subcells within a storage 

modiole. Each bit 2^9«2^ represents a 7 word subcell in a storage 
module. The bits are set as the storage is used. 

11-13 = Another storage cell defining another 306g word of storage. 
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Selection FACILITY SI3MMARY MODULE 



# WORDS 



# WORDS 



MAP & START OF NEXT 



# WORDS 



E2RN ENTRI 



CONTROL 



INFORMATION 



EXRN ENTRI 



CONTROL 
INFORMATION 



I 


# WORDS 


EXRN ENTRY 


1+1 


Fn.E CODE 


LENGTH OF CONTROL 


1+2 




Y+3 


FILE INCRMENT TO ELEMENT 

1 


1+4 




# SETxMENTS 
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Selection Facility Sunnnaiy Module Description. 



General Description 

The selection facility summary is linked off the pre-selection module 
and contains all control statement summarization s which will be processed 
upon selection of the associated task. All parameters necessary are 
contained in the selection facility summary including information 
for the load of the routine. 

The selection facility summary is produced by pre-selection and used by 
the initiation phase of selection. The storage used for the summary is 
released upon the selection of the routine summarized. The modules reside 
in the cooperative library file (ZD). 

Detailed Description 

Word = The link to the next module of control summaries or if there 
isn't any more modules. 

1 = The number of data words contained in this module of control 

information. 

2 = U = The number of words occupied by this control statement 

summari za t ion . 

L = The lower half of the exec return instruction necessary 
for the entry to the routine responsible for processing 
the control statement. 

3 to N= The control statement information whose address is conveyed 
to the processing rputine. The control statement may be an 
ASG, LOG, etc. 

X to 1= Another control statement. There may be any number of 
separate control statements. 

Y = The last entry in the selection facility summary which contains 
the information necessary to load the selected routine. 

U = The number of words in the load entry. 

L = The exec return necessary to process the load, 

1+1 = U = The file code which is to be used in the loading of the. 
element. 

L = The length of the control part of the element. to be loaded. 
This is equivalent the number of words to read in loading 
the element. 
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1+2- = Reserved for the base address of the routine to he loaded. 

1+3 = The increment relative to the base of the file indicated in 
word Y+1, at which the initial instruction of the routine is 
located. 

1+4 = U = Unused 

L = The n-umber of sub-segments contained in the routine being 
loaded. 

After the read of the routine from mass storage the segment 
descriptors (see Loader documentation) will be updated io 
put the loaded element in operating order. 

The parts of the segment descriptor modified are, the 
file code which is replaced by the file code used for. the 
routine load from mass storage. The core bases of all 
- segments will be modified by the base of the routine, the 
file increment to the subsegments will be modified by the 
base of the routine on mass storage. 
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6.30.4- Selection Facility Map 



PERIPHERAL NIME 



# ENTRIES 



,ENGTH SEL SUMMARY 



29 25 

P-TYPE 



24 20 19 15 

CHAN I CHAN 
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LENGTH UNIT SUMMARY 



X+1 



Y+1 



Y+2 



MASTER BIT 
UNIT MASK 



29 

P-TYPE 









15 



CHAN 



CHAN 



14 




LENGTH UNIT SUMMARY 



MASTER BIT UNIT SUMMARY 



PERIPHERAL NAME 1 



^ ENTRIES 



LENGTH SEL SUMMARY 



29 25 

P-TYPE 



24 20 

CHAN 



19 15 14 

CHAN I LENGTH UNIT SUMMARY 
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•Detailed Description 

Word The five character name used for the assignment of 

the peripheral, 

1 U - The number of variable length entries that appear 
under this peripheral name. There is one entry for 
each channel that contains the peripherals that 
could possibly satisfy the routines request. In the 
drawing words 2 to X, X to I are separate entries under 
this peripheral name. 

2 2^9-225 _ A five bit P-TXPE that defines the 
particular type of equipment on that channel. 

224_220 _ This field will be blank except when dual 
channel is utilized in which case it is a five bit 
channel number upon which the units are located* 

2 '^-2'^ _ ^ five bit channel number upon which the 
units are located. 

2 '^-2^ - the length of the unit summary mask contained 
in words 3 to X. 

3 A variable length summary mask with one bits in the 
locations representing units which could satisfy the 
request. This mask will be applied against the master 
bitted units for this channel in the core facility 
and storage summary during selection to determine 

if sufficient unit are available for the selection 
of the task. If the channel has mass storage 
equipment on it ^ the master bit unit mask is omitted • 

X Defines another channel which contains units capable 
of satisfying the request of the routine being 
summarized. Description is the same as word 2. 

X+1 Master bitted units for alternate channel. Description 

is the same as for word 3>4-. 
■f . ' 

Y-Z A summarization of the units acceptable under another 

peripheral name. 
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•Selection Facility Map Description 



•General Description 

The selection facility map is a congested version of the facility 
map. It contains all the peripheral names and unit specifications 
that are used for the assignment of units. The portion of this 
map under a particular peripheral name used on an assign statement 
is included in the preselection sujumary to enable the selection 
routine to determine if sufficient units are available to satisfy 
a routine requirements. 

The selection facility map is produced during initialization and 
used by preselection. It resides on the system library file (ZE). 
The file increment to the selection facility map and its length 
'are contained in the core facility and storage summary (see ) 
whose address is passed in B5. by the content supervisor. 
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7.0 I/Q Coopsrativs Mechanism 

The Input/Output cooperative mechanisms are the system elements 
by which: OMEGA retrieves all scheduling information, in the 
form of control streams 5 and submits accounting and actions 
taken by OMEGA as the result of processing schedule parameters. 

The cooperative mechanism has been designed and implemented to 
control the two way transmission of three streams defined as 
follows: 

' Primary input - device card, tape, drum remote - used to 
contain OMEGA schedule parameters, limited data, source 
'code to assembers and/or compilers, program parameters, etc. 

' Primary output ~ Hard copy of program scheduling results, 
listing from assemblers and/or compilers, limited data, etc.. 
Device normally high speed printer, Univac 1004, remote 
devices. 

♦ Secondary output - device card, tape, drum remote used to 
contain assembler and/or compiler, object code and limited 

data. 

7.1 Cooperative Features 

The Input/Output cooperative mechanism provides the user and 
system with the following advantages and features: 

•The staging of low speed Input/Output data to mass 
storage to balance intermittent system utilization with 
the slow rate peripheral devices. 




OPERATING 
TASK OR 
SYSTEMS 
ELEMENT 



Illustrates two way transmission of 
stream. 
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Staging allows the device to operate at full capacity within 
the controlled constraints of the staging area. The buffering 
to mass storage permits the parallel utilization of low-speed 
devices by operating tasks in a multi -program environment* 

•Provides OMEGA, compilers and/or assemblers, other system 
elements and the user programs a consistent mechanism, 
independent of device to obtain and/or submit data. This 
feature purges system elements of redundant code required 
to assign, recognize and handle varied devices. 



CARD 
EQUIPMENT 




Get 



Item 
Present 



Item 



OPERATING 
TASK OR 
SXSTiEM 
ELEMENT 



PRINTER 
SUB- 
SYSTEM 



Illustrates device independent worker 
interface 

•A pooled staging area is maintained by I/O cooperative 
control allowing multiple streams of primary and secondary 
data streams to utilize a shared library. Data for any 
one stream is threaded by chains to the task. Cooperative 
control expands and contracts the "cooperative library" as 
required to maintain the system. In addition to expansion 
of mass storage, l/O cooperative control will envoke temporary 
suspension and/or Roll-out, Roll-in procedures to control 
overflow conditions. 



7.2 l/O Cooperative Elements 

The elements required to effect the Input/Output cooperative 
mechanism are described as follows and there interaction is 
depicted in Figure 7-1 . 

Input Unit Record Routine - individual routines responsible 
for reading data images from assigned device ajid forming 
these into a buffer the size of which is determined by 
assigned "size of storage modules used for buffering. Upon 
completion of a buffer (module), unit record routine submits 
module for staging by cooperative control. 
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l/O Cooperative Control - is a basic systems element, normal 
resident, responsible for: staging and chaining, Input/Output 
to mass storage, recognizing overflow conditions and calling 
the "Cooperative Service Routine" for action, processing 
requests from operating program and/or system elements for 
primary and secondary Input/Output. 

Primary/secondary Output Unit Record Routine - individual 
routines responsible for recording, punching or transmitting 
items contained in output streams. 

Cooperative Service Routine - is a secondary exec element, 
normal drum stored and responsible for the following with 
regard to cooperative mechanism. 

•Activate selection and load process of unit record 
and edit routines. 

•Initialize and terminate drum chains. 

•Allocate additional mass storage and/or otherwise 
control cooperative library. 

•Perform error recovery for cooperative control. 

j-ju..ll» KOUuliie — inGlVluUa-i. TOmuj^u^o uct,jLa.c;u wjf i-'v/uiw\jaj 

statement to merge and delete supplementary data into 
primary control stream. Normally used to apply correction 
cards against an existing source data file for assemblers 
and/or compilers. May be modified to merge and/or update 
normal data files being entered through the primary input 
stream. 
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7.3 Input Unit Record Routine 

Input unit record routines are normal worker program elements 
responsible for reading and forming into storage modules data 
to be used as primary input. Each primary input U.R. is pro- ' 
grammed to handle a particular device or type of devices and 
is loaded and activated by "Cooperative Service Routine" l^y 
one of the following: 

•Console operator type-in to OMEGA 

UR Name/Version 

where: Name/Version is that of the unit record routine 

being requested. Absence of name/version implies . 
the normal systems primary input unit record 
routine. 

• 'Internal or external "START" control card. The "START" 
statement identifies a pre-stored job stream contained on 
mass storage which is to be scheduled as an independent 
JOB. (see 

•An unsolicited communications interrupt on a device 
assigned to the system in which the first message contained 
"FROM" control statement, (see 

The sequence of functions performed is as follows and illustrated 
in Figure 7-2. 

a) Read items using file code ZA from assigned device 
until a JOB control card is encountered. Pack Job 
card and subsequent images into drum module 
(Figure 7.5-1) as items deleting full words of 
trailing space codes from each image. Upon completion 
of a drum module perform following call to the coop- ' 
erative service routine to set up proper chain descrip- 
tions and store module. 

ENT^B7*Module buffer descriptor 
EXRN%2 3 4 3 

b) Read and pack items into drum module as in step (a) 
and submit completed modules to l/O cooperative control 
with the following call. All error status codes for 
image read may be stored in the upper of item length 
descriptor and will be passed onto requesting program. 

ENTitB7itModule buffer descriptor 
EXRN^^3 4 

Repeat above until a JOB or FIN control card is 
ericountered. JOB card go to step (c) . FIN card or 
6nd«of-f il© go to step (d) . . 
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c) Submit current drum module with an adjusted item count 
excluded JOB card to a "Cooperative Service Routine" 
with the following call which will cause primary input 
stream closure, 

ENT^B7*^Module buffer descriptor 
EXRN^t2 0344. 

Upon return of control move JOB card as first item in ■ 
a drum module and go to step (a) with JOB card. 

d) Submit current drum module with adjusted item count 
to exclude FIN card to "Cooperative Service Routine" 
with the following call, 

ENT^B7*Module buffer descriptor- 
EXRN^t2 0345 

Upon submission of this call control will not be returned, 
primary input stream will be closed and routine will be 
deallocated and terminated. 

Input unit record routines are designed and programmed under the 
following constraints. 

•Assignment of input device used to read images is by normal 
"A3G" control card collected with the unit record routine 
object code element via the LOADER. 

•All U.R. routines are activated and terminated via "Cooperative 
Service Routine (CSR)" and may not FORK or be fragmented. 

•Each routine contains its drum module and description used to 
present items to I/O cooperative control. It is assuiued 
each routine will delete full words of trailing space codes 
• from each image to compact items in drum module. 

•Each routine is initially activated at its first location. 



7-6 



7.3.1 Sample Input Unit Record 
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7.4 Cooperative Control is responsible for the following functions: 

•Maintain a poll of drum modules used to retain primary input, 
output, and secondary output. In performing this function 
cooperative control maintains chaining of modules to the task 
addendum for each stream, recognizes overflow conditions and 
drum read/write errors. 

•Provides the interface with the exec for unit record routines 
used in reading primary inpat or writing primary and secondary 
output . 

•Process service requests for primary input images and/or 
submissions of primary and secondary output by operating worjcer 
programs or system element. To perform this function coop- 
erative control maintains core buffers used .to read staging 
module into core for the transfer of images and verification 
of worker parameters. 

7.4.1 Calls 

Cooperative control is a passive exec element activated 
via EXRN^t300FC. When activated cooperative control 
attains the identity of the requesting task/activity 
addendum. The following is a summary and functional 
description of each function code recognized coop- 
erative control. 



Function 




Code 


Call 


00 


Internal 


01 


CARD$ 


02 


PRINTS 


03 


PUNCH$ 


04 


Internal 


05 


Internal 


06 


Internal 


07 


Internal 


10 


Internal 


11 


Internal 


12 


Internal 



Description 

Call for next primary input image 

Gall for next non control primary input image 

Submit primary output image 

Submit secondary output image 

Submit primary input module 

Request next primary or secondary output module 

Request drum module from cooperative library 

Release " " " " " 

Request release of all cooperative core buffers 

Store last drum module for Job's primary input 

Store last drum and close primary or secondary 
stream 
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Function code 00 - Transfer next image, control or data, contained 
in Job's primary input stream to. the requestor. 

"• Caller: Restricted , to use by OMEGA system elements in order 
to process control statements used in the scheduling 
and execution of tasks. 

Parameters: B7 = to base address of the buffer to which image 
is to be transferred. 

Function: •Detennine existence of ah image. If nbne available 
PUSH request until unit record routine supplies 
another module. If stream is closed and empty return 
end-of-real status,- 
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*If required, locate core buffer and read drum module 
from head of primary input chain* If drum error occurs 
call cooperative service routine with F.C. 22. 

*Transfer image to requestor and update item counts. 

•Deallocate drum module and adjust chain links if 
module was emptied due to request. Return control 
to requestor. 

Exit: The following status conditions are possible upon 
return of control to requestor: 

•"A" register = 0000000000 indicate normal completion. 
"Q" register will be set to number of words contained 
in transferred image. 

•"A" register = 777774-0002 - implies deposit address 
specified by B7 plus image length are outside the 
program lock bounds of the requestor, 

•"A" register = 7777740003 - unrecoverable drum error 
was encountered for the image that was transferred • 
Image may or may not be valid or complete. In the 
event drum chaining was in question primary input 
stream will be deallocated and subsequent requests 
will result in an 05 status. 

•"A" register -, 7777740005 - end-of-primary input 
stream has been reached and deallocated. Upon 
subsequent requests of primary input the 05 status 
will be returned to the requestor for a total of 
three tiines. If a fourth request is made the 
following diagnostic message will be submitted to . 
the primary output stream and the "ERROR" return 
exit will be executed for the activity. Diagnostic: 

END OF PRIMARY INPUT STREAM LOOP 



Function Code 01 - transfer next non control image contained in 
Job's primary input stream to the requestor. 

Caller: Operating tp.sk or system elements for the retrieval 
of source language statements to compilers and/or " 
assemblers, parameters and limited data. 

Parameters: B7 = to base address of the buffer to which image 
will be transferred. 

Function:. 'Determine existence of an image* If. noiie available 
"PUSH" request until unit record routine supplies 
another module. If stream is closed and empty, 
return end of primary input status. 05 



7-13 



•If required locate core buffer and read drum module 
from head of primary input chain. Call "cooperative 
service routine" with FC 22 if drum error, 

•If item is not a control statement (§) in position 
one, transfer item to requestor and update item 
counts. 

•Deallocate drum module and adjust chain links if 
module was emptied due to request. Return control 
to requestor. 

Exit: The following status codes are possible upon return 
of control to requestor. 

'A register = 000000000 - indicates successful 
completion of request! "Q" register contains number 
of words in the image transferred. 

•A register - 7777740002 implies address specified 
by B7 plus, image length, are outside the program 
lock bounds of the requestor. 

•A register = 777774-0003 unrecoverable drum error was 
encountered for the image that was transferred . Image 
may or may not be valid or complete. In the event 
drum chaining was in question primary input stream 
will be deallocated and subsequent requests will 
result in an 0$ status. 

•A register - 7777740004 - indicates next image in the 
primary input stream is a control card (#) sign in , 
first position. This feature can be used to indicate 
end of data cards for this task. Upon subsequent 

, requests via Function code 01 the 04 status will be 
returned to requestor for a total of three times. 
If a fourth request is made an "END OR PRIMARY INPUT 
FILE LOOP", .diagnostic will be submitted to the 
primary output stream and the "ERROR" return exit 
will be given for the activity. 

•A register - 7777740005 - end of Jobs primary input 
stream. The primary input descriptor is deallocated. 
Upon subsequent requests of primary input the 05 . ■ 
status will be returned to the requestor for a total 
of three times* If a fourth request is made an 
I'END OF PRIMARY INPUT STREAM LOOP" diagnostic 
message will be submitted to the primary output stream 
and the ERROR rettirn exit will be given for the 
activity. 
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Function Code 02 - requests the .described print image be 
submitted to the primary output stream. This function is 
applicable to worker programs and system elements for the 
submission of accouting, diagnostic, scheduling messages 
and limited user hard copy. 

Caller: Operating task and/or systems .elements. 

Parameters: B7 = to base address of image relative to PLR. 
Q = number of words contained within the image. 
A =. number of lines to space paper before print. 
, Systems primary output unit record routines 
recognize 77g or greater as a skip to next 
page. 

Function: 'Validate requestors -parameter limits 

•If required locate core buffer and load an 
existing imcomplete module from tail of primary 
output stream descriptor. 

•Transfer image to buffer module deleting full 
words of trailing space codes in order to 
conserve drum storage. If image cannot be 
contained in the drum module allocate next 
link in the chain and store full module, 
transferring image into new drum module. 

•Upon storing a drum module perform the following 
tests: 

Test for task/activity exceeding estimated 
number of pages specified on the Job control 
card. If exceeded, call, "cooperative service 
routine" (CSR), function code (21) GSR will: 
submit "PRIMARY OUTPUT STREAM OVERFLOW" 
diagnostic message to primary output, reset 
overflow indicator and perform an "ERROR" 
exit under the current activity addendum. 

Check for an outstanding PUSH request from a 
primary output U.R. routine selected to process 
the chain. 

Check number of modules contained in this chain 
against the maximum set for the installation, 
if equal, call C.S.R. with function code 20 for 
some disposing action. Maximum set for distri- 
buted version of OMEGA allows for a 3 to 5 
minute backup of print images at 600 lines per 
lainute. 
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Exit: The following status codes are possible upon 
return of control to requestor. 

•A register = 0000000000 indicates successful 
completion of the request. 

•A register = 77777^^0002 implies that the base 
address plus image length are not within the 
program lock limits of the requestor. 



Function code 03 - requests the described image to be submitted 
to the secondary output stream. The secondary output stream is 
normally though of as card punch, paper tape or some slow 
speed mechanical punch device. 

Callers An operating task/activity. Applicable to worker 
programs and for the submission of compiler and/or 
assembler source or object code. 

Parameters: B7 = to base address of image relative to PLR 
Q = number of words contained in the image 

Function: 'Validate requestors parameters 

*If re'^uired locate drum module buffer, descriptor 
and load an existing incomplete module from tail 
of secondary output stream. 

•Transfer image to module buff er deleting full 
words of trailing space codes to conserve drum 
storage. If image cannot be contained in drum 
module, allocate next drum link and store completed 
module transferring requested item into new buffer. 

•Upon storing of a completed module perform the 
following tests. 

Test for task/activity exceeding estimated 
number of images specified on the Job control 
statement. If exceeded call G.S.R. via F.C. 21 
which will perform the following: Submit 
"SECONDARY OUTPUT STREAM OVERFLOW" diagnostic 
message to the primary output stream. Reset 
overflow indicator. Perform "ERROR" exit under 
the current activity addendum. 

Check for an outstanding PUS! request from a 
secondary output U.R. routine selected to 
process the chain. 
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Test number of modules contained in this chain 
against maximum set for installation. If equal 
call C.S.R. with function code 20 for some 
disposing action. Maximum set for distributed 
version allows for a 3 to 5 minute backup of 16' 
word images at 200 images per minute. 

Exit: The following status codes are possible upon return 
of control to requestor. 

•A register = 0000000000 indicates successful . 
completion of the request. 

•A register = 7777740002 implies that the base 
address plus image length are not within the program 
lock limits of the requestor. 



Function code 04 - requests the chaining and storing of indicated 
drum module to the tail of the primary input chain descriptor 
contained in the requestors task addendum. 

Caller: Primary input unit record routine. 

Parameters: B7 = address of drum module descriptor (see 7.5.2) 

Function: •Validate that the drum module and descriptor are 

within the requestors program lock limits and buffer 
does not exceed 198-jo words. 

•Allocate drum link, adjust chain addresses and 
module counts. 

•Store module in cooperative library and return control. 

Exit: The following status conditions are . possible upon 
return control to the requestor. 

•A register = 0000000000 indicating successful 
completion of the request, 

•A register = 7777740002 implies request did not 
pass PLR validation tests. 

•A register = 7777740003 implies invalid parameter 
or buffer exceeded 198-|o words. 

Function code 05 - requests the delinking, allocating and transfer 
of the next module from the head of primary or secondary output 
stream. 

Caller: Primary and/or secondary output unit record routines. 
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Parameters: B7 = address of buffer module descriptor 

B6 = contains indicator as to which chain (O) primary 
(1) secondary. 

Function: 'Validate buffer module descriptor. 

•PUSH request if no modules available. 

•READ drum module into described buffer, 

•Deallocate chain link, update module counts and 
adjust addresses. Return control to requestor. 

Exit: The following status conditions are possible upon 
return of control to requestor. 

* A register = 0000000000 indicating successful 
completion of request. 

•A register = 77777A0002 implies buffer descriptor 
violates program lock limits. 

•A register = 77777^^0005 end of primary or secondary 
output stream. 

Function code 06 - requests 198 words from cooperative library. 

Caller: Restricted to use by OMEGA systems routines. 

Parameters: None 

Function: Retrieve drum module from cooperative allocation 
routine. If modules unavailable request will be 
PUSHed to "cooperative control" until module 
becomes available. 

Exit: Upon return of control "A" register contains 

logical increment of drum module relative to ZD 
file code. 



Function code 07 - complement of Function code 06 j requests the 
release of a 198io words of mass storage procured from the^ 
cooperative library. 

Caller: Restricted to use by OMEGA system elements . 

Parameters: A register = to logical increment of mass storage 
being released. 

Function: Release drum module to cooperative and "POP" any 
outstanding requests for cooperative mass storage. 
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Exit: A register, = 0000000000 implies request complete. 



Function code 10 - deallocate all outstanding core buffers linked 
to task addendums. 

Caller: OMEGA systems element performing a compaction of- 
core function. , 

Parameters: None 

Function: Follow task addendum chain to perform. the following: 
Locate allocated core buffer containing an incomplete 
buffer module and descriptor. Restore to drum each 
one located and release the core storage. 

Exit: A register set to ' 0000000000 indicating completion • 
of the function. 



Function code 11 - requests the storing of indicated drum module 
to the tail of primary input chain descriptor contained in the 
requestors task addendum. 

Caller: Cooperative service routine when activated via 04 
or 05 function code. 

Parameters: B7 = address of drum module descriptor (see 7.5.2). 

Function: 'Store module described by B7 pointer and uixiate 
module counts. 

• "POP" arvv mi+.ej+.nnHn ncr Amacra "rermos+.c! ■frir* -i-.h^ a 

chain. 
Exit: Normal return to requestor A register set o 0000000000. 



Function code 12 - request storing of last drum module, deallocation 
and closure of input phase of primary or secondary output stream. 

Caller: CMEGA systems element during termination process of 
a Job or task. 

Parameters: B2 register set to (O) indicating primary output ' 
stream is to be closed or B2 set to (l) indicating 
secondary output stream is to be closed. 

Function: 'If required located core module buffer, descriptor 

and load existing tail of primary or secondary stream. 

•Store 7 — 7 as logical drum increment to next 

drum module. Record drum module to mass storage 
and update module counts i Check for any outstanding 
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request for the module from output unit record 
routine* If found, POP request, 

•Release core buffer to core allocator used to retain 
drum buffer and descriptor,. 

Exit: Return control to requestor with successful completion 
status A = OOOOOOCXDOO. 
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7. 4*2 Cooperative Library 

Cooperative library is a random access file subdivided 
into modules and used as a pool for the cooperative mechanism 
and other systems elements requiring small pieces of mass 
storage to load programs and otherwise control the OMEGA 
environment. 

An element within cooperative control maintains . the library 
allocating and releasing modules upon request. or need. Address 
and availability of each module is maintained via a bit map 
maintained in core. Format of bit map is as follows: 



Word 







LINK TO NEXT BIT MAP 



BASE LOGICAL INCREMENT FOR MAP 



# MODULES CONTAINED 



TO LAST FIND 



# OF MODULES ASSIGNED 



TO END OF MAP 



BIT MAP 



Word - Used to link bit maps reflecting additional 
allocations of mass storage to cooperative 
library. Zero indicates end of chain. 

Word 1 - Contains base logical drum address to which 
constructed increment from bit map is added 
to form complete address. 

Word 2 - Upper contains number of modules original 
mass storage allocation provides in map. 
Lower is used to maintain a count of modules 
currently being used. If upper and lower 
are equal upon release of a module a call 
is made to C.S.R. Function code 17 for possible 
release of a map. 

Word 3 - Upper contains an increment, . relative to word 
0, of where last find for a module request. 
Lower contains an increment, relative to word 
i to last word of map. 

Word 4.-N - Each bit map word contains 30 drum modules 
showing their availability, and address. 
Each module is represented by a binary bit 
if set to (1) module is available, (O) module 
is unavailable. The address for each module 
is formed by following formula: 
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Module address = {(30»W)+Bj M + D 

where: W = is word count within bit map of 
available module relative to word 4 

B = bit position of available module 
within (W) through 29 , ' 

M = module size SQt at 198 . 

D = the content of word 1 

To determine the bit position within a map of , 
released module the following procedure is used: 

•Determine wlxLch bit map module belongs 
,D-|_released module ■ D2 

• [(released module - D^)/^ /30 quotient = W,. 

remainder = B 



Cooperative Library Allocation 

Allocation of random access storage and forming the corresponding 
bit maps is performed by the cooperative service routine (C.S.R) 
upon demand of l/O cooperative control or systems initialization. 
This is perfomred by executing a call to C.S.R. with function code 
16 (see ). Upon return of control status, word will indicate 
successful allocation or not. l/O cooperative control will request 
additional allocations of mass storage each time total modules 
available drop below constant specified in bit map chain descriptor. 

Bit Map Chain Descriptor 

Contains chain call to bit maps and other descriptive information 
with regard to module allocation. And is contained with the 
"System Table Links" (see ). 



Word 



MINIMUM DRUM MODS 



MAHMUM # OF CORE BUF. 



CURRENT # DRUM MODS 



LIBRARY BIT MAP CELL 



PUSH/POP CELL (C.CO 



# OF BUFFER STEALS 



CURRENT # OF CORE BUF. 



# OF BIT MAPS FORMED 



PRIMARY OUTPUT M AX. 1 SECONDARY OUTP UT MAX. 
"cTs.R PUSH/POP CELL 



Word - Upper contains minimum number of modules system 

should degenerate to before additional allocations 
of mass storage is made. If additional storage is 
not received upon request cooperative control will 
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allow library to drain and "PUSH" all unsatisfied 
requests until module is released. Lower contains 
a count of total available modules summarized from 
all bit maps. 

Word 1 - Contains chain cell to cooperative library bit maps. 

Word 2 -• Contains PUSH/POP cell for request which could not 
be performed by cooperative control. 

t 

\ Word 3 - Upper contains count of maximum number of core 

buffers which should be assigned within system at 
any one time to contain primary or secondary data. 
Lower contains a count of core buffers currently 
allocated and used for primary or secondary data. 

Word 4 - Is used for statistical data* Upper - number of 

times a core buffer area was stolen from one stream 
to satisfy another request. Lower contains a count 
of additional mass storage extensions which were 
effected for the cooperative library. 

Word 5 - Contains maximum number of drum modules which should 
be contained on dr-um for any one stream before some 
disposing action is called for. When any one stream 
reaches the maximum "cooperative control" will call 
C.S.R. by function code 20 to cause one of the following 
to occur: activate output unit record routine, allocate 
additional mass storage, temporarily suspend requesting 
program. 

Word 6 ~ Is used push/pop cell for cooperative service routine. 



Additional Uses of Cooperative Libraiy 

Currently OMEGA utilizes the cooperative library to maintain 
lists and tables used in selection, allocation and control of 
tasks. The following lists are currently contained and assure 
198 word modules. 

•Selection Job Stack (see 6.30.1) 

•Job descriptor module (see 6.30.2) 

•Pre-summary module (see 6.30.3) 

•Selection facility map (see 6.30.4) 
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7.4 .3 Functional Routines 

DPOP - routine to 'POP' certain request that have been 
'PUSHed' on a general ^PUSH' chain. 

Caller: Cooperative Control 

Parameters: B6 = address of current task addendum 
B2 = type code by which requests are to 
be ^POPed' as follows: 

01 = POP a request fpr an input image 

if the task is the correct one. 

02 = POP a request for an output image 

if the task is the correct one. 

03 = POP a request for entry to DGET. 

04 = POP a request for entry to DRGET, 

05 = POP a request for a core buffer. 

06 = POP a request for a drum module. 

Functions •Search the general "PUSH" chain by type 

code for a request which has been 'PUSHed' 
with that code in the A register. 

•In the case of types 01 and 02 a match must 
also be made on "the task that the request 
was made during. 

•If a match was made, 'POP' the request that 
the match was made during. Exit in either 
case. 

Exit: Return on completion. 



DGET - services requests for 202D word' core buffers. 

Caller: Cooperative Control 

Parameters: B6 = address of current task addendum 

Function: 'If the maximum number of buffers has not 

been allocated, make a call to core allocation 
. for a buffer . 

•If the maximum has been allocated, or if 
the above request is not filled, follow the 
task addendum chains to locate one of the 
allocated buffers which is not in use. 
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•If none such are found, 'PUSH' the 
request until a buffer becomes available, 

•When a buffer is found, empty it onto ■ 
the drum (if necessary) , 

Exit: A register contains address of obtained 
buffer on completion. 



7-P«5 




F i^'^vi t^r^ Cocfe 00 ^,.. . .{' i 



-for- l^CfOp 
















i 



our JU..^»' 



Op a4.ft Cosjtsi-i 









f t/t^ c'^ tO^ Co ((4. B. CJU«^t ^ 



Re kJl f% t^ f 

hiod'J U 










Mo 1 T'H * 4 / 




7a Sp0 < * . 





C-/\f~c 






/^u ^ cf/a^ Code Y' 




lENTe, 



Com /iltre 
Mo do(* 



/-^U ^L e>T Cif-^ do cL^ 5"^ 








r Oi^^f^o^T. *^'=><^C -^ ^ 



^. 






Code - 
i 




HiM 



p — it^ 



C^^€ 10 





No 





PRGET 








Uc 



CcJt = 

6 




DPOP 
0Lf 



PRGBT 







f Uir^ cT lo^ ^ O d^ J kf 




X 






Rf^( Mod, 












DROP 

2 








tx> 

cv 

i 




DPOP 




DCrE 








, .. , . . »„.., . ..... .. .. ., 



<i 



/Tp^^ff 









CM 
1 



7,5 Cooperative Maps and Tables 
7.5«1 Drum Module 



Drum modules are used by cooperative control and unit record 
routines to contain items transferred to or from random access 
storage. 

Word 



197 



DRDM INCREMENT TO NEXT MODULE IN CHAIN 



# OF ITMS IN MODULE 



I 



TO NEXT ITEM DESCRIPTOR 
# OF mmS IN ITEM 



ITEM 1 



# OF mWS IN ITEM 



ITEM 2 







LAST ITEM 



Fig. 7.5-1 



Word - contains drum increment of next module in the chain 
and is controlled by cooperative control. 

Wordl - upper contains # of items currently within the chain. 
Lover is an increment from word fi of next item or 
free area within the module* 
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Word 2, J & K - are item descriptors required for each item 

contained within the module. Lower is number 
■ of words contained in the item excluding the 
descriptor. Upper contains number of lines to 
space before print if item is primary output or 
contains error status code from unit record 
routine or drum retrieval is primary input. 

Word 3 through J-1, etc. contains primary input, primary output 
or secondary output images dependent upon which 
chain drum module is linked. 



Module Size Drum module size has, been fixed at 198^ p. words as determined 
by the following constrants. 

. The module must be a multiple of a FASTRAND sector to improve input/ 
output efficiency if cooperative library is allocated to FASTRAND, 

» Drum modules are of a fixed size due to pooling mechanism and assoc- 
iated program space but contain images from varying device and image 
lengths. To determine some criteria 16 word card images and 27 word 
print lines were chosen as normal. The module size should therefore 
be a multiple of both to reduce wastage of mass storage. 

• A third consideration is the cooperative mechanism's routines delete 
from each item full words of trailing space codes to reduce mass 
storage requirements. To make this effort meaningfully the drum 
module size should as be as large as possible without requiring allo- 
cation of leirge core buffers which may be dormant. 

The following table illustrates alternate, choices of module size. Each 
module requires two words for module descriptor and is assumed to contain 
17 word card images excluding item descriptor or 28 word print lines 
including descriptor. The table does not take into consideration exclusion 
of space codes from end of images. 
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# OF WOBDS 
IN MODULE 


# OF CABDS 
CONTAIN 


CAED 
WASTAGE 


# OF PRINT 
LINES 


PRINT 
WASTAGE 


33 


'1 


16 


1 


3 


66 


3 


13 


2' 


8 


99 


5 


12 


3 


13 


132 


7 


11 


4 


18 


165 


9 


10 


5 


23 


*198 


11 


9 


7 





231 


13 


8 


8 


5 


2U 


15 


7 


9 


10 


297 


17 


6 


10 


15 


330 


19 


5 


11 


20 


363 


21 . 


4 


12 


25 


,396 


23 


3 


14 


2 


UZ9 


. 25 


2 


15 


7 


.462 


27 


■ 1 


16 


''2 


493 


29 





17 


1 r 



* 198 chosen for system. If heavy utilization of cooperative mechanism 
is made 396 or larger would appear to be a good alternate choice. 
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7.5*2 Drum Module Descriptor 

The Drum module descriptor is used as the l/O packet in trans- 
ferring Drum modules to or from the mass storage. The des- 
criptor is utilized by both unit record routines and l/O cooper- 
ative control, however all modification of drum increments is 
restricted to cooperative control. Descriptors format is as 
follows; 



Word 
Q 

1 

2 



FILE CODE 



# OF WOEPa TKAjgSFSE 
19eD 



BASE ADDRESS OF DRUM 
MODULE 



DRUM INCREMENT OF CURRENT DRUM MODULE 



Word - Upper contains File Code ZD indicating the l/O transfer 
is to cooperative library. Lower contains number of 
continuous words contained or used in the drum module} 
limited by convention to 198^q maximum. 

Word 1 - Base core address into which drum module is to be trans- 
ferred. Address is relative to PLR of requestor. 

Word 2 -Contains logical mass storage address, relative -feo file 
code* ZD, of dinm module being processed* 
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7.5»3 Chain Descriptor 

Each stream of data (primary input, primary and secondary output) 
requires a unique descriptor to maintain its links and other 
controls. These controls are maintained in the task addendum of 
the Job and are of the following format: 

Word 



1 

o 

<. 

3 

k 

5 

6 

7 

10 

11 

12 

13 

U 



IZQ 



PRIMARY OUTPUT MAXIMUM SECONDARY OUTPUT MAXIMUM 



DRUM LINK TO CURRENT HEAD OF MODULE CHAIN 



DRUM LINK TO CURRENT TAIL OF MODULE CHAIN 



ADDRESS OF CURRENT CORE BUGGER 



TOTAL # OF MODULES 



# OF MODULES IN SYSTEM 



DRUM LINK TO CURRENT HEAD OF MODULE CHAIN 



DRUM LINK TO CURRENT TAIL OF MODULE CHAIN 



i^ 



ADDRESS OF CURRENT CORE BUFFER 



TOTAL § OF MODULES 



# OF MODULES IN SYSTEM 



DRUM LINK TO CURRENT HEAD OF MODULE CHAIN 



DRUM LINK TO CURRENT TAIL OF MODULE CHAIN 



iZc. 



ADDRESS OF CURRENT CORE BUFFER 



TOTAL # OF MODULES W OF MODULES IN SYSTEM 



PRIMABI 
FILE 



PRIMARY 
FILE 



SECONDARY 
OUTPUT 



Note - Drum Link set to 7 — 7 implies end of chain. 2^"^^ set 
to 1 implies partial module stored on drum. 

Word - Upper contains maximum n\mber of pages converted to 
modules of primary output expected for JOB. Lower 
contains maximum number of cards converted to modules 
expected for the JOB. 

Words 1, 5 & 11 contains logical drum address of head link in 
chain. 

Words 2, 6a12 contain logical drum address of tail link in 
chain which is currently stored on the drum. 

Word 3, 7 & 13 are used to contain core address of a buffer 
containing Drum Module and descriptor when: an 
image is being transferred to an operating program • 
(Word 3) or a primary or secondary output images is 
being accepted by cooperative control from an oper- 
ating program. When interrogating these core cells 
they have the following meanings: 

18 
2 -2 non-zero implies address of buffer descriptor 

with drum module immediately following. 2-2^° set 

to zero implies no buffer or descriptor currently 

allocated to stream. 

2 set to (1) indicates buffer currently in use and not 
available for re-assignment, release or use until current 
process complete. 

Words Lf, 10&14- Upper is used to maintain a count of all modules 
allocated for described stream used for accounting and 
error overflow* Lower contains a count of Drum modules 
currently contained on mass storage for the stream. 
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7 lb Output Unit Record Routines 

Primary and secondary output unit record are normal worker 
program elements responsible for punch, print, transmit or 
otherwise process primary or secondary output streams. Each 
routine is programmed to handle a particular device or type 
of devices and is called for and activiated by the "cooperative 
service routine" due to one of the following: 

t Particular output stream has reached its maximum length 
as determined by comparing the number of modules in the 
system contained in tasks chain descriptor against 
maximum allowed value contained in "Bit Map Chain 
Descriptor". 

s 

. Job stream is teminating at which time "TERMINATION" will 
request activation of output unit record routines. 

The sequence of functions performed by 6ach routine is as 
follows : 

a) Request first module of assigned chain from cooperative 
control function code 05. First item of module contains 
an accounting or identification item to be outputted as 
first image. 

b) Request next module of assigned chain from cooperative 
control function code 05. Submit each item contained in 
drum module to assigned device. Buffer area for Drum 
module and descriptor are contained in the unit record 
routine. Repeat this step until end-of -stream status code 

\ status code is returned for a module request "A" register = 
7777740005, 

c) Exit to "cooperative service routine" Function Code 07 
primary output or Function Code 11 secondary output. 
Program control may be returned at the starting location 
to process a new stream. 

Output unit record routines are designed programmed and run 
under the following constraints: 

. Assignment of output device used to output images is by 
normal "ASG" control card collected with the unit record 
routine object code element via the LOADER. 

. All U.R. routines are activated and terminated via "cooper- 
ative service routine" smd may not FORK or be fragmented. 

. Each routine contains an area for drum module and descriptor 
used to accept drum modules from l/O cooperative control. 
All items contained in drum module have had full words of 
trailing space codes deleted. 

• Each routine is activated at its first location.* 



7-35 



7.7 EDIT Routines 



7-36 



8.0 Real Time and Communication Control 
8.1 General Description 

The Omega communications softwere is very flexible allowing 
the user to optimize it to best serve his needs, yet it is 
highly efficient and capable of handling an -unlimited number 
of devices of all the various types. One user mijght desire 
a high level interface between lie software and user programs 
similar to File Control software. Thus allowing him to use 
simple commands such as "SEND" t.id "RECEIVE" on a certain 
file, the software would then ha: die the details of buffering, 
translating, packing, unpacking, polling, establishing remote 
connections, etc., as needed. Wl.lle another user might prefer 
to maintain closer supervision a\^T the communication functions. 
This user as an example can hand3»j his own polling or buffering, 
etc. These user programs would teen of necessity have to be \ 
more detailed and precise. 

8.1,1 Level n Control 

The level 1 OMEGA Communications Software provides the User 
with a low level, basic routine (ESI CONTROL) which controls 
the hardware. The User Program essentieG-ly has complete 
control of the hardware by commands which are given to ESI 
CONTROL. ESI CONTROL will perform the actual input-output 
hardware instructions as directed by the User Program. 

Communications Facility assignment routines are provided in the 
Level 1 software. These routines allow units which are not 
in use, to be acquired and assigned to the requesting User 
' Program. A Commtunications Facility Map will be maintained 
* on Ramdon Access Storage which lists the units, mnemonic 
names for them, and the xmits which are in use. 

The User Program will perform all editing, translating, packing, 
unpacking and staging of messages. It will also have to fom 
the poll output messages eind monitor the input poll replies. 
Any special control requirements of the various devices will 
have to be recognized and provided for in the iU^er Program. 

"CTM Control Blocks" and "Unit Control Blocks" are tables in 
memory which will contain control type information used by both 
ESI CONTROL and the User Program. These tables are fonned as 
the units are a-cquired by the Comm. Facility Assignment routines* 

This Software should fill the need of Users with specialized 
communication systems, which do not require the flexibility of 
OMEGA Communications Interface Level 2, And some Real Time 
Programs presently in existence may be able to efficiently 
utilize the Interface Level 1' Software* 
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Level 1 Control 
Fig. 8-1 



8.1.2 Level 2 Control 



The lowest level of Software is the "ESI CONTROL" routine. 
ESI CONTROL executes the hardware functions, interprets the 
interrupts and provides other basic communication with the 
hardware. There is only one Communications Function Executor, 
but it may communicate with any number of "Communications 
Handlers". The "Communication Handler" is the next h^'gher 
level routine. A Handler might be specialized for a type of 
remote device, a particular buffer scanning technique or 
unique to a particular applications program. The handler 
might connect directly into some user programs or the 
"Communications Director". The Communications Director 
provides a buffering or staging mechanism for the input and 
output messages, depending upon activity these may be queued on 
mass storage to preserve space in core memory. It is 
the Communications Director which interfaces into the high 
level user program providing him with input messages and 
accepting his output messages for subsequent transmission to 
remote communication devices. The Camnnmlcations Director 
has other miscellaneous functions, one of which is Identif^rlng 
unsolicited messages. 
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8.2 TABLES 



In order to control the various connmii cation devices certain information 
is required concerning the characteristics of the remote units smd 
transmission lines. Current status and control infoimation must also 
be available. For this reason the following tables have been established: 

. C1M Control Block 

• Unit Control Block 

. Conmnmicatipn Facility Map 

8.2.1 CM Control Block 

The CTM Control Block is A 30g word (Level 2) packet containing 
information relative to a particular CIM. There is one such Control 
Block in core for each currently active CTM pair. These Control 
Blocks are formed and placed in core as a CTm pair becomes active 
(see Section 8.2.3). The Control Blocks are accessed from a table 
based on ESI address (see Section2..1.i^) The .table is referenced 
by the ESI Interrupt Processor, the Communication Handler, and the 
Communication Director (Level 2). The C!IM Control Block is shown 
below with a description following. 



OjM Control Block 






STATUS 


# WORDS 


1 


JOB # ■ 


ACT # 


2 




ADDRESS 


3 . .. 




UGB LINK 


4 


CIM TYPE 


INPUT BUFFER SIZE 


5 


ESI (OUTPUT) 


MPLX&CTM I.D. 


6 


CODE TYPE 


CHANNEL NO. 


7 




ACTIVE UGB 


10 


INPUT CHAIN ODUNT 


OUTPUT CHAIN GOOJT, 


11 


30MMAND WORD 


EXTERNAL FUNCTDDN 


12 


INPUT BGW (HEAD OF CHAIN) 


13 


OUTPUT BGW (HEAD OF CHAIN) 


U 


INTERRUPT CONTROL 


15 


INPUT MONITOR CNH 


OUTPUT MONITOR GNT 


16 


INPUT ESI BGW 


17 


OUTPUT ESI BGW 


20 


ESI EXTERNAL INTERRUPT WORD 


21 


SPA 


RE 


22 


ESI (DIAL) 


MPLX & cm I.D. 


23 


POLL PERIOD 


TIME OF NEXT PCLL 


2A 


HEAD OF D 


ROM CHAIN 


25 


TAIL OF DRUM CHAIN 


26 


CORE BUFFER 


27 


PUSH/POP LINK 



c» o -» 



Word O-upper - Status of CM 

1. DOWN-BIT 29 set 

2. INPUT ACTIVE-BIT 28 set 

3. OUTPUT ACTIVE-BIT 27 set 

Word 0-lower - Number of words in this list. The number of 

words may vary depending on whether Level 1 or 
Level 2 control is being used. 

Word 1 - The Job and Activity number of the Communication 
Handler controlling this CTM. The ESI Interrupt 
Processor references this location when executing 
a QBEF to the handler. ^ 

Word 2 —Address of the handler controlling this CTH. 
Control is transferred to this address when 
the QBEF above is made. 

Word 3 - Chain cellto first Unit Control Block (see 

Section 8.2.2). All UCB's associated wiidi this 
CTM are chained through this cell. 

Word i^-upper - C!M and transmission line characteristics are 
listed here. Possibilities include: 

. synchronous/asynchronous 

. simplex/half duplex/full duplex 

. dial/automatic dial/poll 

. line speed 

Word 4-lower - Input buffer size. The ESI Interrupt Processor will 
obtain this size input buffer from the buffer chain 
when required (see Section 8.3). 

Word 5-upper - ESI for the output CTK. The input ESI will be one 
greater. 

Word 5-lower - The actual multiplex and CTM I.D. code (used to 
send external functions to the CTM). 

Word 6-upper - Data Code type (ASCII, X3-3, etc.), code level, etc. 

Word 6-lower - l/O channel number 

Word 7 - Address of UCB which currently has an input or 
output message in process. 

Woird 10 - Input and output buffer chain counts in upper €Lnd 
lower respectively. Each time the ESI Interrupt 
Processor- chains a buffer the appropriate half- . 
word is incr^asnted. Ifay be used h^' the handler 
to locate currently active input and output buffers. 



Word 11-13 - ESI Function Executor control words. Described 
in Section S.U»2, 

Word 14 - Interrupt Control Word. Specifies ESI Interrupt 
Processor action at interrupt time. See Section 
0*4. 1 . 

Words . 1 5-20 - Control words used by the ESI Interrupt Answering and 
Interrupt Processing Eoutines. See Section 2.1.2.2. 



Word 21 

Word 22-upper 

Word 22-lower 

Word 23 
Words 24-27 



- Space location, may be used by handler for control. 

- ESI address for the DIAL GTM. Will be j^ if there 
is no DIAL C!IM associated. 

- The actual Multiplex and DIAL COM I.D. code used 
to send external functions. Zero if there is no 
DIAL GTM. 

- Poll period and time of next poll of the remote 
units on this CIM. Will be zero if not a poll line. 

-Control information for drum queue of output 
messages for this CIM (Level 2 only). See section 8.6 



8.2.2 Unit Control Block 

The Unit Control Block is a 14.g word packet containing information 
relative to a particular remote device. There is one Unit Control 
Block in core for each remote unit currently assigned. These Control 
Blocks are created and placed in core as each unit is assigned'. 
They are accessed through a chain cell originating in the GTM 
Control Block. They are referenced by the Communication Handlers 
and the Commuication Director (Level 2), The Unit Control Block 
is shown below with a description following* 

Unit Control Block 
(UCB) 





1 

2 

3 

4. 

5 

6 

7 

10 

11 

12 

13 



STATUS # OF WORDS 1 




CTM/UCB LINK 




GTM CONTRDL BLOCK 


OUTPUa 


' BCW LINK 


UNIT I.D. 
UNIT I.D. 




TA/UCB LINK 


# MSG'S # WORDS (MSG) 




HEAD OF DEDM CHAIN 




TAIL OF DRUM CHAIN 




CORE BUFFER 




PUSH CELL 
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Word 0-upper - Status used by the Handler to indicate such things 

as: 

DOWN REMOTE UNIT 
REMOTE UNIT RESERVED 
INPUT ACTIVE 
OUTPUT ACTIVE 



lower - Number of words in this UNIT CONTROL BLOCK 

Word 1 -. GTM/UCB Link. A chain cell linking all units on 
a CTM to each other and to the CTM. The chain 
originates in the CIM. 

Word 2 - Address of the CIM Control Block to which 
this UCB is linked. 

Word 3 - Output BOW Link. A BCW specifying a chain of 

output connnunication buffers to be sent to this 
unit. An output message may be linked through 
this location by the handler when the CTM is 
active with another message. This buffer would then 
'^be established by the handler when tHe c\irrent 
message has been completed. 



Words i^,5 



Word 6 



Words 7-13 



.Unit I.D. Information necessary to identify the 
remote unit. May contain phone number for a dial 
unit, poll code, transmitter start code, etc. 

TA/UCB Link. A chain cell linking the UCB to the 
Task Addendum of the program to which it is assigned. 
All units assigned to a task are linked together 
through this cell. 

Control infonnation for input drum queue of messages 
from this unit (Level 2 only) . See Section ^'^ . 
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8 •2.3 Coifflnunications Facility Map, 

The Cofflmuni cations Facility Map is a table, located on 
Random Access Storage, which has a listing of the units, the 
mnemonic names they may be called 1:^, the handlers which 
shoaild be used, Unit Control Block information. Communications 
terminal Module (CTM) information and a summary of the units 
which are in use. This map will be set up at Systems 
Generation and later referenced by the Communications 
Facility Assignment Software routines as units are acquired and 
released. 




1 
2 
3 
4 



X 
X+1 
X+2 



ABC ^HANDLER DESCi 7UNIT DISC. 



A TO UNIT DESC LIST A TO HANDLER DESC LIST 



SIZE OF USAGE LIST 



TO USAGE LIST 



COMM UNIT NAME 1 



B 



^^HANDLER PESO ^tJNIT DESC. 



B 



ABC 



? 



COMM UNIT NAME 2 



C V HANDLER DESC V UNIT DESC. 



HANDLER DESGJ 7 UNIT DESC. 




Word U - The increment from the base of the map to the 
first unit description, 

L - The increment from the besse of the map to the 
first handler description. 

Word 1 U - The number of words reserved for the usage list, 
Each usage entry requires two words. 
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L - The increment ftom the base of the map 

to the first word of the first entry in the usage 

list. 

Word 2 A Communication Unit name by which asssignment 
will be requested. The "ACQUIRE" statements 
will refer to these names. 

Word 3-4 2^^ (a) = One or more alternate handler - 
unit descriptor words following for this unit 
name. 

2^° (a) = 1 Final handler- unit descriptor 
word for this unit name. 



2^^ (B) Undefined 
tP (C) Undefined 



2 -2 '5 The index to the handler description 
to be used on this assignment. This index is 
relative to the base of the handler description • 
list. 

1Z. 
2 -2 The index to the unit description to be 

.used for this assignment. 

Word X Another unit name which may be used for assignment. 

Word Xf1« Eeferenoes to handler and unit descriptors ■ 
X+2 for this unit name. Similar to words 3 and 4 
above. 
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Communications Handler Descriptors 
(Initialize and Locate) 



The mnemonic names previously defined points to a "Handler 
Initialize" descriptor, which describes a routine which will be 
loaded, executed and discarded* This routine will perform initial 
setup functions as required by the "Handler", The Handler Initialize 
Descriptor points to a "Handler Locate Desci'iptor" which describes 
a handler to be used for the normal handling of comimmication messages* 
The handler locate descriptor will indicate if the handler is 
presently in core, and if so where it is located. 

HANDLER INITIALIZE DESCRIPTOR 




1 
2 

3 
4 

5 



HANDLER INITIALIZE 
NAME 
VERSION 



FILE INCREMENT TO HANDLER INITIALIZE 



T 



LENGTH (HAN, INIT . H V KANDLSE LOCATE 
UNDEFINED 




Word 0-2 Contains name/version of communications "Handler 
initialize'.' routine. 

Word 3 Contains the drum address of the routine. If 

Os indicates no initialize necessary, proceed 

immediately to "Handler Locate" descriptor. 

Word 4 U - Nimber of words of core req\iired for this 
Handler Initialize Routine 

L - The index to the "Handler Locate" description 
to be used on this assignment. This index is 
relative to the base of the handler description 
list. 

Word 5 ■ Undefined. 
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HANDLE LOCATE DESCRIPTOR 




1 
2 
3 

5 • 



HANDLER 
NAME 
VERSION 



FILE INCREMENT TO HANDLER 



HANDLER LENGTH I ^ OR HANDLER CORE ADDR. 




Word 0-2 Contains name/version of communications "handler" 
routine. 

Word 3 Contains the drum address of the handler. 

Word 4 n - Number of words of core required for this 
handler. 

L - Address of Handler if in memory or 0a if 

not in memory. 

Word 5 Number of Communication Units currently using 

this "Handler". When this count becomes the Handler 
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Communication Unit Descriptors (UNIT and CTM) 

The word or words immediately following the mnemonic nacae point to 
a "Unit Description" which is a small table containing unit status 
and other information unique to a unit. A pointer within the unit 
descriptor points to a "CTM Descriptor" which describes the CTM 
for this unit. The Unit and CTM Descriptors are interrogated to 
determine if the requested communication tmit aay be successfully 
ACQUIRED! If so I a Unit Control Blodk will b« formtd lia mtmsrat, 
also a CTM Control Block, unless a previously acquired unit required 
the same CTM Control Block in which case it would already be in 
memory* 

UNIT DESCRIPTOR 



I/O 



CTM DESC 



STATUS 



# WORDS ON DRUM 



# WORDS IN CORE 



UNIT I.D. 
OR POLL CODE 



Word 0, 2^ If "1" indicates unit is not available for 
use at this time, it is either down or already 
in use. If "0" unit is available. 



.2 -2 "^ The index to the CTM descriptor, 
index is relative to the base of the unit 
description list. 

1 A 
2 -2 The niamber of words this descriptor 

occupies on drum. 



This 



Word 1 U - Status information pertinent to this unit. 

L - The number of words required in core to form 
a. Unit Control Block from this unit description. 

Word 2£p3 A unit identification or poll code which may be used 
by the handler. 
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CTM DESCRIPTOR 




1 
2 
3 

5 
6 
7 



STATUS 



CTM TYPE 



ESI (OUTPUT) 



CODE TYPE 



ESI (DIAL) 



§ WORDS ON DRUM 



ef OR ADDRESS IN CORE 



# WORDS IN CORE 



INPUT BUFFER SIZE 



MPLX + CTM I.D. 



CHANNEL NUMBER 



MPLX + CTM I.D. 



PERIOD BETWEEN POLLS 



Word Number of words this descriptor occupies 
con drum. 

Word 1 Memory address if a Control Block has been 
set up for this CTM, otherwise Os. 

Word 2-5 Specific CTM information, required to form the 
CTM Control Block in core memory. 

Word 6ri-7 Additional CTM Control Block information, not . 
always required. Dial or pollable CTMs require 
this information. 
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Communications Unit Usage List 

A drum stored list is maintained which contains unit identifying 

information for the units which are currently being used. The 

Unit Control Block core memory address is paired up with the indexes 

of the Handler Initialisseand Unit Descriptor which were used when 

this unit was acquired. Thus by searching the usage list and following 

the indexes , a unit and its associated software components may be 

thoroughly analyzed* 




1 
2 
3 
k 
5 



I/O 




ADDR OF UCB 


VHABDLER DESC. 


7 UNIT DESC. 


^ 


( 


L ' 




\ 


— 



Word 



Word 1 



2^^ = 1. Indicates this word and the following 
word contains unit identifying information for a 
unit which is presently being used. If 0, this two 
word slot is not being used at the present time. 

217«20 The core address of the Unit Control Block. 

U - The index to the "Handler Initialize 
Descriptor" . 

L - The index to the "Unit Descriptor". 



Word 2,3 
& on 



Same as worcls and 1 but for a different unit. 
Each unit in use will, have a 2 word entry in this 
list. 
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8.3 Buffers 



Two types of buffers are used in Omega communications: communication 
buffers and packing buffers. Communication buffers are used to 
receive and send data at the hardware level while packing buffers are 
used to exchange data between the Communication Handlers and the 
Director or the application program. 

8.3.1 Communication Buffers 

Communication buffers are used to transmit and receive data ■ 
from the Communications Subsystem. The same buffer may be 
used for both input £ind output; input entering the upper 
half word and output exiting from the lower half word. 
These input and output buffers although occupying the same 
memory locations are distinct in that they have no connection 
with each other. The input and output buffers may also be 
of differing size. The common point of these distinct 
buffers is the end of the buffer as shown in Figure 8-3. 

Each communications buffer contains ' three control words 
located at the end of the buffer. These control words 
allow input and output buffer chains to be developed 
separately. The "Input BCW Link" is the acutal buffer control 
word of the next buffer of the input chain. The "Output 
BCW Link" is the buffer control word of the next buffer of 
the output chain. If either of these two words is zero it 
indicates that this buffer is the current end of the corres- 
ponding chain. The number of words in the third control 
word is the size of this core area. This value is used by 
the core chain control routine for allocatiiig or releasing 
buffers. 
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OUTPUT BCW LINK 



# WORDS 



FIG, 8-3 
COMMUNICATION BUFFER 



These input and output links if present are used at interrupt 
time by the ESI Interrupt Answering Routine as the new input 
and output buffers for the terminating ESI as described in 
Section 2. 1,2. 2, When the Input BCW Link is zero, the ESI 
Interrupt Processor obtains a new input buffer and links ^it 
to the terminated buffer. An Output BCW Link of zero implies 
the end of an output message. 
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8.3*2 Communication Buffer Chain Control 

An area of core is reserved for communication buffers by 
the Communication Initialization Routine. This reservation - 
is made through a variable core chain declaration (Section 4-0) • 
The size of the buffer area is established at system 
generation time. 

Three chain numbers have been assigned for communication 
buffer control - Chain No.' s 3, 4, and 5. Chain No. 3 is 
the area described in the paragraph above. This chain is 
taken from free core and set aside for input and output 
communication buffers. Chain No.'s 4- and 5 are the input 
buffer and output buffer chains respectively. No chain 
declarations are made for these two chains - the areas 
placed in these chains are obtained by the chain control 
from Chain No , 3 . Requests for buffers are made only f rop 
chains 4- or 5, as appropriate. 

ENTRY' - Entry to chains No. 4 and 5 may be made either 
AND from the ESI Interrupt Processor or from the n 

EXIT Communication Handlers. Entry from the handler 
is via an Executive Return instruction with 
Darameters stiecified in the registers! 



Memory Request 



ENT^B7 


VO 


ENT^Q 


V1 


EXRN 


40001 



where: Vn is the chain number referenced. 

Chain U is the input buffer chain and 
Chain 5 is the output buffer chain. 

V^ is the number of words requested. 



Control is returned following the EXEC Return, 
with the address of the last word of the buffer 
in the A register. 

Memory Release 



ENT*B7 


VO 


ENT^A 


V1 


EXRN • 


^ C( Ci 2 



-where: Vq is the Chain Number being referenced: 
Input Chain No. Uv Output Chain No. 5. 

V^ is the address of the last word of 

the buffer {not including the three control 

words)-. 
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The chain control routine must be readily available 
to the ESI Interrupt Processor in order to establish 
input buffers. For this reason the processor enters . 
the chain control with an Enter B and Jump instruc- 
tion. The same parameters given above apply. Control 
is returned following the "EBJP" instruction. 

Operation - A buffer request is made to chain No. 4 

or 5 either by the Interrupt Processor or 

. by the handler. If the request cannot be 
satisfied from the chain referenced, the 
chain control requests an area of core from 

. chain No. 3 (if chain No. 3 cannot satisfy , 
the request, chain 3 control requests the 
area from the Free Core Chain), The area 
obtained is placed in the chain which was 
not referenced. The length of the area is 
placed in the third control word. 

An example will clarify the situation. 
Initially Chains 4 and 5 are empty, and 
Chain 3 contains all the core allocated to 
communication buffers. Suppose the Interrupt 
Processor requests 60 words from the Chain 4, 
Chain 4 is empty so chain control requests 
64 words (3 words are need for chain and 
link control and one more is added to make 
a multiple of 2) from Chain 3. The lower 
half of this 64 word area is still available 
to be used as an output buffer; so chain 
control places this area in Chain 5. When 
the buffer is released to Ghain ^- a check 
is made to see if the corresponding buffer 
exists in Chain 5. If so, the area is 
removed from Chain 5 and the complete area 
released to Chain 3 J if not, the input 
buffer being released is placed in Chain 4* 



8.3.3 Packing Buffers 

Packing buffers are used to exchange data between the 
Communication Handler and either the application program 
• (Level 1 ) or the Communication Director (Level 2) . 

At Level 1 where the handler passes information directly 
to the program, any convention may be established concerning' 
the packing buffers (they may be a part of the program) , 
The program could be informed of a full packing buffer 
either by a QREF, activity registration, jump instruction, 
or guiy other means available. At Level 2, however, the 
staging mechanism of the CoMounicatiotL Director must operate 



with a pre-defined format as shown lie low* 



# 


WORDS 


t 


CONTROL 






DATA 


• 



The first word of the packing buffer contains the numbeir 
of words of data in the buffer and a control indicator- 
such as SOM, EOM, etc. The remainder of the buffer 
contains data converted and packed to any degree desired 
by the handler. 



On. input the handler obtains data from the Communication 
buffer and places the data in the program's packing buffer 
(data format in the packing buffer is determined by the 
handler) . On output the handler obtains data from the 
packing buffer and unstrings the data (if necessary) into 
a communication buffer for transmission. The acquisition 
and release of packing buff ers- is explained in Section 8.5.4* 



Any or all of the previous output options may be 
selected. If both Option 1 and 2 are set, Option -1 
will take priority. When the "Output BCW Link" of 
the terminating output buffer is not zero, the new 
buffer will always be established. 

External Interrupt (2^-2^) . 

Option 1 (2^ aet) - Execute a QKEF to the handler 

when an external interrupt occurs^ 

, . Option 2 {2^ set) - Establish a new input buffer. 

... (either from the "Input BCW Link" ^ 
or from the input buffer chain) 

, Option 3 (2^ set) - Send a "Look for Sync" function 

when an external interrupt occurs. 

Any or all of the above options may be selected. 



8,4,2 ESI Function Executor . 

In addition to the functions performed at interrupt time 
by the ESI Interrupt Processor, the handler at times may 
choose to send certain external function commands to 
various CTM's, and establish buffer control words in the 
ESI locations. These functions are handled by the ESI 
Function Executor. This routine is classified -as- an , 
"immediate function" routine - it is entered through an 
Executive Return instruction, the functions are executed 
•in the Executive Mode, and control is returned immediately 

packet: 



ENT^^Q 


VO 


ENT*A 


2f el el 1 5 


EXRN 


el el el el ef 



where Vq is the address of the CTM Control Block 
defining the functions to be performed. 

The functions to be executed have been pre-stored 
in the CTM Control Block before the above packet 
is issued. Bit settings in the upper of word 11 of 
the CTM Control Block define the functions: 

2^9 = i Send "Look for Sync" external function 

2^^ =1 Set input BCW. Word 12 of the CTM 
Control Block will be moved to the -. 
input ESI BCW position defined by 
word 5 of the Control Block. 
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8*4 ESI Control 

The Communication Handlers define the method of control to be 
used for a particular CTM. Two routines are available to the 
handlers for this purpose: The ESI Interrupt Processor and 
• the ESI Function Executor . 

8.4..I ESI Interrupt Processor 

Through the ESI Interrupt Processor (See Section 2.1 .2.2) the, 
handler controls the sequence of events on the occurrence _ 
of an ESI interrupt. This control is accomplished T^y 
Tneans of the "Interrupt Control" word (lower of word 
fourteen) of the CTM Control Block. Through this 
word a course of action is described for input monitor 
interrupts, output monitor interrupts, and external 
interrupts separately as follows! • 

Input Monitor (20-2^) 

Option 1 (2O set) - Execute a QREF to the handler when 

and input monitor occurs- ( if 2^ is . 
not set, no QREF will be made). 

Option 2 (2I set) - Send a "Look for Sync- function to' 

the CTM. 

Option 3 (2^ set) - Do not chain a new input buffer when 

the "Input BGW Link" is zero.' 

Any or all of the above options may be selected. 
When an "Input BCW Link" exists in the terminating 
buffer the new BCW will be established regardless of 
any of the above bit settings. If the link is 
zero the Interrupt Processor will obtain and establish 
a new buff er unless Option 3 has been selected. 

Output Monitor (2^-25) 

Option 1 (23 set) - Execute a QREF to the handler when 

an output monitor occurs. If 2^ is 
not set a QREF will be made only when 
the "Output BCW Link" of the termina-' 
ting buffer is zero. 

Option 2 (2^ set) - Do not QREF the handler when the 

"Output BCW Link" is zero. 

Option 3 (25 set) - Release the terminating buffer to the 

output buffer chain (Chain No. 5) 
and update the "head of output chain" 
(word 13) of the GTM Control Block. 



2^*7 = r Set output BCW. Word 13 of the 
CTM Control Block will be moved 
to the output ESI BCW position 
defined by word 5 of the Control 
Block, 

226 ^.-j . ; Set output BCW for DIAL CTM. 

Word 13 of the CTM Control Block 
will be moved to the output ESI 
BCW position defined by word 22 
. of the Control Block, 

2^^ = 1 . , Send external function* The function 
code contained in bits 2^-2^ of this 
word (word' 13) will be sent to. the 
■ . CTM defined b^ word 5. 

224 _ ^ gQj^^ external function to DIAL CTM. 
The function code contained in . ' 
bits 2^-22 of word 13 will be sent 
to the. CTM defined by word 22, 



Any combination of the bits given. above Will result 
in the execution of the corresponding functions. A . 
conflict may occur concering the output and DIAL 
CTM's; therefore, when 7?^ is set, 2^6 will be ignored, 
and when 2^5 is get, 2^^ will be ignored. The bits 
are examined and the functions executed in the order, 
■given above. Any deviation from this established 
order will, necessitate the issuing of two. or more 
successive commands. 

The bit settings describing the function. to be performed 
are stored in the upper of word 11 of the ~GTM Control ' 
Block, the function code in the lower of word 11., if 
applicable, the input buffer in word 12, 'and the output 
buffer in word 13. The above packet is then issued. 
Words 12 and 13 then become the new heads, of the input 
and output buff er chains respectively. 



8. 4*3 Channel Initialization and Termination 

• The Intialization and Termination of communication channels 
is accomplished "by means of an "immediate function" 
command. Initialization is perfomred when the first 
communication facility is assigned , and termination is 
performed as the last communication facility is released. 
The' following packet is used; 



ENT^Q. 



VO 
0.0 



ENT^^A 



2 1 



£i ei (^ ei 



EXRN 



where: "^q is a code indicating either initialization 
or termination. 



I'Then Initialization is indicated the routine will clear 
all ESI locations and set input. and' output active on all 
ESI channels. Clearing the ESI locations will prevent 
data .from entering core and cause, a word of all bits 
(CTM stop code) to be sent to a CTM if it requests output 
data. Synchronous GTM's come on in the "Look for Sync" 
mode when power is applied, so that the external function' 
need not be issued during initialization. 

When a termination operation is indicated, input and 
output will be terminated on all ESI channels/ 



8.4-4 



8,5 Comnrunication Handlers 

The Communication Handlers interface between the Interrupt Processor 
and the application program. Data manipulation between the ;coiffliiuni- 
cation and packing buffers is accomplished by the handlers. The 

■ handlers may be written to handle a remote unit in any manner desired 
by the user. The handlers also may initiate output, initiate polling, 
specif^r input and output comnrunication buffers, acknowledge the 
remote device, reset ESI boffer control words, search input buffers, 
etc. 

Communication handlers are written for a particular type of remote 
unit J however, they are not restricted to only one CM — one handler 
may communicate with many CTtl's, In this case, the handler must be 
coded such that it is non-re-entrant with respect to an individual 
GTM and re-entrant with respect to different CTM»s. 

■ ")8,5#1 Interrupt Processor Interface 

Input - 

Many options exit in the manner in which the handler commamicates 
with the Interrupt Processor (IP). In fact, the methods which 
may be employed seems to be limited only by the imagination of 
the progrsMaer* With respect to the communication buffers, • 
the handlers may obtain buffers in the same manner as does the 
IP or the handler may let the IP obtain additional input buffers. 
Using the former method the handler may obtain two (or more) 
input buffers and link them together with the link of the last. 
buffer. pointing to the first buffer, ThuSj when the last 
buffer is filled the Interrupt Answering Routine re-instates 
the first buffer effecting a re-circulatlon of buffers. With . 
the above method the handier also has the option of being refer- 
enced when an input monitor interrupt occurs so that the buffer 
may be processed, or the handler may periodically scan the 
buffer chain for end of transmission codes. Another method, 
the handler could use is to periodically scan smd remove data 
from the communication buffer and reset the buffer control word. , 
This procedure would minimize, if not prevent, input monitor 
interrupts. If a monitor did occur data would not be lost since 
the IP would obtain a new input buffer and chain it to the 
expired buffer. Input communication buffers which have been 
obtained by the IP should be released to the buffer chain .by 
the handler as soon as the data has been removed. These 
input buff ers may then be obtained and used again by the IP, 

The handler instructs the IP on what procedure to follow when 
a monitor interrupt occurs by setting certain bits within the 
GTM Control Block of the interrupting ESI. These bits may be 
varied dynamically by the handler. The options currently 
available are described In. Section 8.4«1* 



When these bits indicate that the handler desires control 
after an interrupt has occurred, the IP executes a QREF to the 
handler with the address of the CTM Control Block in the A- 
register, and the terminating buffer in the Q-register, The 
handler to be referenced by the IP is identified by words 1 
and 2 of the CTM Control Block. These words contain the JOB 
Number, Activity Number and address. of the handler. The JOB 
Number will be that of the program which is to receive the 
data. The handler operates under the identity of the receiving 
program, but at a higher priority than the program proper. 

The handler may instruct the Function Executor to set up 
cdrtain input and output buffer control words (ESI' s) and issue 
certain External-Function commands to the appropriate CTM. ^ 
These functions are performed immediately by the Executor and 
control is then returned to the handler. Multiple functions 
concerning the same CLT may be performed with one command. A 
predetermined order. of execution has been set up which should 
cover most contingencies. Deviation from the execution order 
will require two or more references to the Executor, See Section 
B,J+,2 for execution order and location of function and buffer 
words. 

Time dependent control is available to the handlers as well as 
worker programs. These functions may be used for buffer scanning, 
acknowledgement remote units, etc. The time dependent functions 
are described in Section 5-0, 

Output - 

When the complete message has been placed in a communication 
buffer (or ch-ain of buffers) the handler may check the CTM 
status in the CTM Control Block to see if output is cur rent ly 
active on the CTM, If not, the handler may initiate output to 
the unit by instructing. the Executor to set up the initial buffer, 
in the ESI address and. to send an external function to the CTM, 
If output is currently ' active the handler may indicate in the 
UCB that a complete message is ready, or the handler may 
possibly qhain the message to the currently active output 
buffer chain. 

When An output buffer chain exists the monitor interrupts are 
handled completely by the Interrupt Answering Routine. If the 
"Output Buffer Link" in the terminated buffer is not zero it 
is the Buffer Control Word of the next buffer in the chain and 
■is immediately established. The IP at this time may also return 
the terminated buffer to the Output Buffer Chain if instructed • 
to do so tQT the handler. The buffer would not be returned to 
the chain if the message was being sent to two or more G0M*8 
as in a message switching application. When ail output monitor 
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occurs and the biiffer link is zero, a new buffer is not 
established; the handler has either placed an "end of 
transmission" code in the buffer, or the handler will allow 
the I/O hardware to send the EOT when the G1M requests again 
(the l/O hardware will send a word of all bits and an 
acknowledge when it finds an ESI word count of zero). 

Upon finding an "output buffer link" of zero the IP may QREF 
the handler to inform the handler that the complete message 
has been transmitted. At this time the handler may search 
the Unit Control Blocks associated with the CTM to detect 
and initiate any additional messages queued for output to 
that CTM, A reference to the handler when an output monitor 
occurs is optional} the option is exercised by setting the 
appropriate bits in the Interrupt Control Word of the CM 
Control Block (see Section 8.4-. l). 

8.5.2 Data Handling 

Communication Handlers move input data from the communication 
buffers to the packing buffers. During this operation any '• 
data manipulation required may be performed by the handler. 
For example, the handler may check character and message 
parity, the handler may convert the incoming message code to 
any internal code required by the program, and/or the handler 
may pack the data to aiiy degree in the packing buffer. 

To facilitate any or all of the above operations certain 
locations within the CTM Control Block may be used for control 
purposes. The upper half of word 4 will contain information 
identif^dng the level of the CTM pair and word 10 contains 
the input <xode type (ASCII, XS-3, etc.). 

Hnadlers to be used for input to the System (such as the OMEGA 
Scheduler) will convert the data frooa the input code, to 
Fieldata code and pack the characters five to a word in 
the packing buyers. 

Upon receiving a packing buffer of output data, the handler 
requests a communication buffer from the Output Buffer Chalir, 
The handler then unstrings and converts the data as required 
placing the data in the communication buffer. If the message 
in the packing buffer was incomplete the handler requests 
additional data in the same or another packing buffer. The 
buffer control word of the first buffer may be placed in word 
3 of the appropriate UCB, When the additional data is 
received the handler obtains another communication buffer as 
above and chains the second buffer to the first by means of the 
"Output Buffer Link" as described in Section 8.3 •!• 
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8, 5 .3 User Interface (Level l) 

Level 1 control implies a close association between the handler 
and the user program. Any method of program organization may * 
be employed. The handler may be contained within the user 
program code or the handler may be "contained in one of the 
libraries (job, group, system). An XREF may then be used 
to collect the handler with the user program. The handler 
may be established as a separate activity with higher 
priority than the user. Time dependent activities for buffer 
scanning may also be registered. 

Packing buffers may by areas within the user program or they 
may be obtained from a core chain by the handler or the user. 
Packing buffers and their status may be exchanged between the 
handler and the user by any means available (i,e« QREF, activity 
registration, jump instruction, etc.). 

The user program may consist of different levels of core # The 
handler exit, for example, may be to an edit and/or drum queuing 
routine for retrieval at a later time by a user message 
processing routine, 

8 •5*4 Communication Director Interface (Level 2) 

When operating with level 2 control, the handlers interface . 
with the Communication Director for queuing of messages on 
the drum (specified CTM»s may still operate with level 1 
Control while others are controlled at level 2). 

In level 2 the handlers originate the commands given to the 
Communications Director, After performing the command the 
Director returns to the handler with a status indication, 
^e pirector operates as an extension of the handler although 
possibly, at a different priority. 

The following commands are available to the handler: 

, Queue Input Message — The handler has a packing buffer of 
date to be queued against a specific remote unit* Control - 
is returned upon completion. 
Parameters reqtiired - 

, Unit Control Block address , 

, Packing buffer suidress 

• Queue Input Message and release Packing Buffer - The 
Director will queue the messiage as above azid release the 
packing buffer. 
Parami^ters required - 

. Unit Control Block address 

. Packing buff er address 

• Number of vords to release . 

• Core chain No* 
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, Request Output Message — The handler requests an 
output message for a specific CTM, A status will 
be returned indicating whether or not a message 
is available. If available th'e appropriate UCB 
will be indicated. 
Parameters required - 

.CTM Control Block address 

.Packing buffer address and number of words 

• Obtain Output Message — The handler requests an , 
'output message for a specific CTM. Control will 
be returned only when an output message is available. 
Parmeters required - 

.CTM Control Block address 

.Packing buffer address and number of words 

. Request Output Message and Packing Buffers — Same 
as Request Output Message except that the Director 
obtains a packing buffer from a core chain. Director 
returns buffer address and. number of words. 

.CTM Control Block Address 
.Core Chain Number 

. Obtain Output Message and Packing Buffer - Same a 
Obtain Output Message except that the Director obtains 
the packing buffer. Director returns buffer address 
and number of words . 
Parameters required - 

.CTM Control Block address 
•Core Chain Number 

The handler executes the commands by loading the registers 
with the appropriate parameters and giving an EXECUTIVE 
RETURN instruction. Control is returned following the 
EXEC RETURN with the status and other information 
contained in the registers. 
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8*6 Gommunication Director 

General Description 

-The Communications Director is a group of routines which 
make it possible for the user to write his programs to a 
higher level interface, freeing him from the communicaion 
device dependent details. The user will simply "ACQUIRE" 
units by a mnemonic name, then issue "SEKD" and "RECEIVS" 
commands. A high degree of flexibility is still provided 
the user such as "ACQUIRE"ing a group of units, being able 
to "SEND" to any one or all units of a group and issuing 
"RECEIVE" commands for a message from a specific unit or 
from any unit in a group. There are other commands: ""DIAL",'.. 
"HANG UP", "POLL", "RELEASE" and "TRANSFER" which allow :* ' 
optimization and sophistication while still at the high ■ 
level. 

The Communications Director is composed of numerous elements, 
divided so as to perform specific functions. Only the high 
usage elements will be in core all of the time, others such 
as "DIAL" will be in core only while it is being used. 

Another major function of the Commuiiications Director is 
t^8 staging of Input and Output messagos on Random Access 
Storage • Thus allowing the timing of the communication 
devices and the User Programs to be completely independent. 



Detailed Description 

ACQUIRE may be performed by either a control card or by 
a statement within the User Program. The ACQUIRE causes 
Communication Facility assignment to secure, if available, 
the unit or units implied by the NAME or GROUP and assign 
them to specified File Code. A f DIAL"" operation may or 
may not be implied at this time, thus perhaps insuring the 
program not only of on site hardware facilities, but also 
that a connection has been: made with the remote device. 
If "DIAL"ed when "ACQUIRE"d or if this unit was connected 
by a direct wire, "SEKD" and "RECEIVE " commands could be 
issued immediately. 
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RECEIVE is a User Program command which indicates it is ready 
for an input communications message. The Receive command will 
be associated with one of the users File Codes. Previously 
at ACQUIRE time a unit or units were linked to this File Code, 
so now the "EXECUTE RECEIVE" routine of the Communication Director 
is able to locate the unit from which input data is requested. 
The first message or portion of a message received from this unit, 
which has not been given to the User Program, will be located and 
transferred to the User Program's buffer, which was furnished 
with the RECEIVE command. 

A GENERAL "RECEIVE" command from the User Program means an input 
message will be accepted from any one of the units linked to the 
specified file code. The "Execute Receive" will scan down through 
the list of units looking for a message. When a message is found, 
it is transferred to the users buffer. A minor File Code will 
be given to the user, thus allowing him to reference the same 
unit again. 

"Queue Input Message" is the Communication Director routine which 
receives the input messages from the Communication Handler, It 
will form strings of input messages, one string for each communications 
input unit. These strings will be formed on Random Access Storage, 
An input message may go directly from the "Queue Input Message" 
to the "Execute Receive" and to the user if there is an unsatisfied 
"RECEIVE" command. 



SEND is a User Program command which implies output data is to 
be sent to a remote unit or units associated with a specific 
File Code of this program. The User Program assembles a com- 
plete or partial output message in its buffer, then it executes 
a "SEND" command, specifying the number of words, buffer base, 
a File Code and whether this is. the end of a message or not. 
The "Execute Send" portion of the Communication Director will 
store the message on Random Access Storage forming an output 
string for each Communication Output CTM. Unit identification 
and end of message indication will also be .stored with the 
message. The same message and end of message indication with 
different unit identification will be Random Access stored for 
each unit that is to receive this output "SEND" message, to 
satisfy a "SEND" to multiple units. If a Communication Handler 
had previously requested an output message for a CTM, which 
was not satisfied, the next "SEND" message for this CTM will 
be given immediagely to the "REQUEST OUTPUT MESSAGE" routine 
of the Communication Director, thus the drum store need xiot 
always take place. 
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The user with numerous input units on one File code (major) 
might like to know how many input messages are waiting to be 
processed. A "CKISTAT" command executed by the User Program 
will cause a Communication Director routine, "Status Checker" 
to be loaded into core and executed. This routine will count the 
number of units . assigned to this user File Code and store the 
count in a buffer like area furnished by the User Program. The 
number of messages and the number of words of the next message 
for each unit that has not been processed will also be stored 
in this buffer area. . Thua, the User Program can determine 
the unit with the largest backlog of input and might like to 
alter his processing accordingly. 

A "Dial and Hang Up Routine", allows a User Program to "ACQUIRE" 
a unit which is essentially an Input/Output' with Dial' CLT 
combination. Then with "DIAL" and "Hang Up" commands a number 
of remote connections may be made, one at a time. Perhaps 
a Poll by "DIAL" arremgement. This also allows the user program , 
to "HAND UP" after all of the input data has been received) then, 
when the output is ready to be sent, "DIAL" the number again. 

A "Poll Control" routine allows a User Program to' give "POLL" 
STOP or START eoDanands for a unit or all units on a Fili Code, 
These commands given to non-pollable units will not affect them. 
The polling is controlled by the. Communications Handler, .it will, 
poll or not poll a particular unit as per the last "POLL" 
command received. The unit description In the Communications 
Facility Map has provisions for declaring the unit as pollable or 
non-pollable and whether polling should be intiated when the unit 
is "ACQUIRE!»d. - • , " 



When a User Program determines there is no more activity for a 
unit, a "REILEASE" command may be executed. This will cause a 
"HANG UP" operation if it was a dialable unit and the unit will 
become available for other "ACQUIRE"s. The Unit Control Block 
will be cleared from memory. If no other units are using the 
CM CB, it too will be released. If this happened to be the last 
communication unit operating the Communication Director will also be 
released. 

A User Program may also "TRANSFER" a unit to the Communications 
Director. This indicates the User Program no longer has any 
need for this "unit, but there is the possibility of unsolicited input 
on this unit. Thus the Communication Director has complete control 
of the unit as if it had "ACQUIRE"d it. 

Unsolicited and unidentified input messages may occur only for 
those Ainits which are assigned to the Communications Director. 
The Transfer Unit Control section of the Communication Director 
will be a small unit control section which will be in core as 
long as some units remain' assigned to the Communication Director. 
When input is received from one of these units, it will not be 
known at this time which User Program it is for or it might be 
an input job stream. The Communication Checker will be loaded 
and will determine if the input message is the start of a job stream. 

J.X OV/ UilO Ck^^X V/JkiJL J.CX UO UXl^U IVOUUX'U i.UJUUXXiO WXJLX uo j-uixueu txiiu. wxxx • 

ACQUIRE the unit from the Communications Director and .proceed in a 

normal manner. If the message was not a job stream, 

further attempts will be made to identify it and then inform the 

proper User Program, If a User Prpgi'am caaanot be found for the 

message, it will be discarded and perhaps logged -as an error 

situation. 
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8,7 User Program Interface Level 2 

This describes the commands and interface which the User Program 
will use when cosmiunicating with the Communications Director. 
The following are the commands which may be used. 

Commands Explanation 

. #ACQ. ■ External "ACQUIRE" request for a communications unit 
or group of units received via a control card, 

ACQ$ Internal "ACQUIRE" request for a comminications tmit 
or group of units. 

DIAL$ Direct that a "DIAL" operation be performed. 

HANGUP^ A line, disconnect operation will be performed. 

RELE/ISE$. A previously acquired unit or units will be released. 

SEND$ A "SEND" operation passes an output message from the 
UseroProgram to the Communications Director. 

RECEIVE A User Program request to the Communications Director 
for an input message. 

CKISTAT$ Provides the User Program with the status of the 

input messages received by the Comm. Director which 
have not been passed onto the User Program. 

POLL Allows a. User Program to set a unit or units, so they 
will be or will not be polled. 

TRANSFER This transfers control of a unit or units ftom the 
User Program to the Communications Director or from 
the Communications Director to the User Program. 



Deatiled Description of the Commands 

ACQUIRE 

An ACQUIRE command zoay be executed either by a control card or by 
an internal program statement. The ACQUIRE will be performed In the 
same manner regardless of how it is initiated. 
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#ACQ A Options A NAME, File Code, XX- XX 

ACQ$il Options A NAME, File Code, XX. XX 

NAME If "G" is not specified as an option, this is a 5 character 
mnemonic NAME of the desired communication unit. The 
Communications Facility Map will be searched for a match 
to this mnemonic name. 

If "G" is specified as an option, this is then the "NAME"* 
of an element which contains one or more NAME' s of comm, 
units which are listed in the Comm. Facility Map. The 
search for this C210UP NAME element will be first to the 
JOB library then the GROUP library then to the SYSTEMS 
library. 

File Code Is 1 or 2 alpha characters which represent the File Code 
this unit, is to be connected with. If Comm. units have 
previously been assigned to this File Code, the newly 
acquired unit will be added at the end of the chain. The 
' minor file code number will be given to the user,. The 
minor file code is a binary number indicating the relative 
chain position of a particular unit. 

H- — -SuH This is an external number to be used by the X (DIAL 
EXTERNAL number) option. 



OPTIONS 



MEANING 



u unuur. xnuicaues i^ae a Aim paramei^er is i^ne name ox £ui eiemen'o. 

The named element then contains one or more comm, unit mnemonic 
names, 

A ABSOLUTE. Ignored unless G option is also present. In which 
case, the "A" indicates all units named in the Group, element 
must be acquired for this ACQUIRE to be successful, ' 

D DIAL. The number contained in the Unit Descriptor will 
be dialed. This ACQUIRE will be successful only if the 
number can be successfully dialed. The dialing will be 
executed automatically if the automatic dial CTM is 
■ available otherwise the operator will be instructed to 
perform the dialing, 

Z EXTERNAL. Dial number specified. Dial operation to be 
executed similar to the "D" optioni except the external 
number will be used. • • 



ri n n 



DIAL 



DIALj/^Field Code, # of words, buffer base. 

A DIAL operation will be executed using the nimiber that is 
contained in the buffer. The dialing will be executed 
automatically if the automatic dial CTM is available, 
otherwise the operator will be instructed to perform the 
dialing. An unsuccessful status will be returned if . 
the dial connection cannot be successfully completed. 



HANGUP 



HANGUP$AFile Code 

A hang up or disconnect operation will be performed. 
If the connection was performed by an operator, he will 
now be instructed to hang up, . 



BELEASE 



SEND 



release! A File Code/File Code (minor) , • 

A previously acquired unit or units will be released, will 
become available for use by other programs. All units 
acquired for this File Code will be released unless a minor 
File Code is also specified. 

The minor file code is a nimber indicating the relative 
acquired position of a particular unit. The first xmlt 
acquired would have a minor file code, of 1 , the second 
unit's minor file code would be 2, etc. 



SEND$AFile Code/File Code (minor), #of words, buffer base. 

The "SEND", command directs the sending of the output 
message contained in the buffer, to be sent to the unit or 
units specified by the File Codes, The presence of a minor 
file code indicates the message is to go to a specific unit. 
The message will be sent to all units associated with 
this file code if a minor file was not, specified. 



RECEIVE 



RCV$AFil6 Code/File Code (minor), # of words, buffer base, . 

The RECEIVE commaind secures a complete message from the unit 
or one of the units as specified by the file code and places 
it in the specified User Program buffer* The absence of a 
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CKISTAT 



minor file code indicates the first full message located,' 
which had been received from one of the xmits associated • 
with the major file code will be acceptable. 

An unsuccessful status will be returned if a full message 
isn't available from the designed unit or units. 

FECVlAFile Code/File Code (minor), # of words, buffer base, 

The PARGIAL RECEIVE command is the same as the RCV command' 
except it does not require a complete message to be available 
prior to passing some of it to the User Program, 

An unsuccessful status will be returned only when there 
is no input data from the applicable unit or units. 

RC7W$ZiFile Code/File Code(minor), # of words, buffer '.ase, 



The RECEIVE WAIT command is the same as the RCV| command %^th 
one exception. That is, if a full message is not available 
control will not be returned to the User Program with 
ail unsuccessful status. But instead control will be held 

when a message becomes complete, it will be placed in the 
buffer and control will then be returned to the User Program, 

PRGVW$AFile Code/File Code (minor) ,# of words, buffer base, . 

The PARTIAL RECEIVE WAIT command is similar to the PRCV$ 
command except it does not return an unsuccessful status 
when there is ho input data. Instead control will be 
held by the Comm Director until some input d&ta is available. 



CKISTAT$6 File Code, # of words, buffer base 

A command which allows a User Program to obtain the status 
of the input messages which have been received by the Comm.- 
Director but not yet requested by the User Program, 
Thus the User Program might alter its processing technique 
depending upon the backlog of input messages. 

This command will store the major and minor file codes of 
the last unit acquired for this file code (major), in the 
first word of the specified buffer. The number of messages' 
and the number of words of the last partial message by 
unit, which have been received will be stored in the buffer, 
second word on up, A word will be stored. For each unit, 
they will be in nimerical sequence matching the minor file 
code« 



POLL 



TRANFERT 



'PR ATOTPTPRT? 



POLLr$A File Code/File Code (minor). 

This command will set the unit or units specified so 

they may be polled during the normal Communication Handler 

poll sequence. If a minor file code is specified, it 

indicate that only that unit should be set to the 

"poll yes" condition. If a minor file code is not listed, 

all units associated with the major file code will be 
set to the poll condition. 

POLLN$AFile Code/File Code (minor) 

This command will set the specified unit or units so they 
will not be polled by the Communication Handler. If a 
minor file code is specified, it indicates that only that 
unit should be set to the "poll no" condition. If a minor 
file code is not listed, all units associated with the 
major file code will be set to the non-poll condition. 



•iAANFj!ittT$ ^File Code/Vile Code (minor). 

This allows a User Program to "Transfer To" the Communications 
Director a unit or units as indicated by the file codes. 
The Communications Director will retain control and monitor 
them for unsolicited input messages •: 



TRANFSIF$A File Code 

This command enables a User Program to obtain a Unit 
from the Communications Director which had been previoiisly 
"TRANFERT"edi -The unit will be obtained and associated. 
With the designated file 'code. 
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8.8 Communications Facility Assignment 

A niwiber of Communications Facility Assignment software routines 
provide, orderly control of the system's communication hardware and 
some software as well. These Facility Assignment routines provide 
the following: 

A drum record of the hardware currently available . 

A list of hardware currently in use. 

Satisfying a user program's request for communication unit hardware* 

A means of allowing some hardware to be used by more than one program. 

On other hardware, insuring that only one program uses it at a time. 

The user to mnemonicly request communication units. 

The assignment of alternate units if the requested is unavailable. 

The correlation of certain software or user routines with the 
hardware communication units. 

Automatic loading into core of the above mentioned routines. 

"DIAL" functions if specified on the "AGQl? statement. 

"GROUP" assignment of communication units,' if requested and if 
possible. 

Insuring that hardware and software usage conflicts do not , " 
develop. 



The Communications Facility Assignment routines have to perform 
the above for both Interface Level 1 and Level 2, since both may 
be in operation at the same time. 

The control of the Facility Map, method of handling the "ACQUIRE" 
and "RELEASE", and the core memory tables (Unit Control Block and 
CTM Control Block) are essentially the same for both levels. The 
major difference is that Interface Level 2 has, to tie in additianai 
Software routines such as the Communication Handlers and the various 
portions of the Comraanication .Director. 
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Communications User Interface Level 2 Facility Assignment 

The Level 2 Facility Assignment will be explained in a general way^ 
to present an overall picture of the communications control. The 
Facility Assignment is composed of numerous routines, these will 
not be distinctly broken down at this time. The tables (Facility. 
Map, UCB and CTM CB) explained in an earlier section are quite 
closely involved in the Facility Assignment, 

Initially at Sys'tem Generation time a Comiaunication Facility Map 
is generated. This map is drum stored. It is at this time when 5 
character mnemonic names will be linked to a specific communication 

omit, with possibly some alternate units. 



ACQUIRE 

Acquire is obtaining the assignment of a desired unit or units to 
satisfy a user program request. The user program will execute an 
"#AGQ" control card or an "ACQ$" internal program statement, both of 
these accomplish the same thing. The ACQUIRE specifies either a 5 
character mnemonic which refers to a pre-established unit name listed 
in the facility map or an element name which is composed of one or 
more 5 character mnemonic names. An option G character in the Acquire 
statement indicates that an element is named. The G group option is 
necessary if multiple units are desired for one Acquire statement. 
When the G option is present, Facility Assignment will perform, a 
search for the named element. First it will search the "JOB" library, 
then the "GROUP" library and finally the "SISTEM" library. Note there 
may be more than one element with this same name,, but the first which 
is located will be the one that is utilized. The 5 character NAME or 
NAMEs found in this element Will now be used, the same as if they had 
been listed in the ACQUIRE statement , 

Now that the actual NAME or NAMEs are known, communication facility 
assignment will proceed to use them for its first reference to the 
Facility Map. The map will be searched for a match to the specified 
name, when it is found, the next word will be used to locate the 
unit descriptor and the handler initialize descriptor. These descriptors 
are also located in the Facility Map, The unit descriptor contains 
available or unavailable indications (unavailable is already in use or 
down) for the unit. If available, the CTM descriptor (also in Facility 
Map), specified by the unit descriptor will be referenced. The CTM 
descriptor contains information which indicates: available or 
unavailable, is or is not presently being used by another unit, and 
whether it can or cannot be used by more than one unit af the same time. 
If the CTM is available arid not in use, it will now be marked as in use' 
and a CTM Control Block will be formed in core memory. A Unit Control 
Block will also be formed in memory at this time and the unit descriptor 
will be marked as unavailable. As the CTM CB and UCB are formed in . 
memory they will be linked together, each containing the address of 
the other J also, an entry is now made in the unit usage section of the 
facility map. This is a two word entry with the first word containing 
the core address of the UCB and the second word contains tlie pointer 



word which was found and used following the 5 character name, it 
pointed to the unit descriptor which was just used and to a handler 
initialize descriptor. Note, if the CTM was in use and could have 
more than one unit using it at same time, the CTM CB would not be 
formed at this time, since it is already in memory. The linking 
.(CTM CB-UCB-UCB and UCB - CTM CB) would still take place, also the 
usage entry would be listed. 

Kow theCTl'l CB and UCB have been set up, with everything successfuly 
up to this point, the facility assignment will now proceed with the 
necessary handler control processing. As mentioned previously, a 
pointer to a handler initialize descriptor has been found following 
the 5 character mnemonic name. This Handler Initialize Descriptor 
(it is in the Facility Map) will be located. If some set up or 
initializing is necessary this descriptor will contain the drum address . 
of the Handler Initialize routine, it will be loaded and control given 
to it. When the Handler Initialize is finished, control will be 
returned to facility assignment. Facility assignment will now loca^,e 
the "Handler Locate Descriptor" as listed in the Handler Initialize 
Descriptor. The Handler Locate Descriptor contains information which 
indicates if the handler is presently in core and how many users it 
has, also where it may be found on drum. If it is not in core, it will 
be loaded, its core address and a user count of one will be stored into 
the Handler Locate Descriptor, if already in core the user counter 
would simple be increased by one. Now that the handler is in core its 
address will be stored in the CTM CB. 

The above indicated the desired unit was available, it did not conflict 
with the unit capacity of the CTM, thus the unit was able to be successfully 
assigned. But, if all of these conditions could not be met, the 
assignment process would be halted and the previous environment would, 
have to be re— created* Such as if the CTM was previously being used 
by another unit with a different handler and since a CTM can .only be 
associated with one. handler at a time; this assignment of this new 
unit would have to be halted, the UCB destroyed, the usage entry 
deleted, and the CTM CB - UCB - UCB chain recoupled.. Facility assignment 
would now go back to the NAME pointer section of the facility and if an. 
alternate pointer was available, it then would try to assign the unit 
it pointed to (such as same type of unit but a different CTM) . If 
there are no alternates or if none, of the alternates can be acquired, 
an unsuccessful status will be returned to the user program. 

If the ACQUIRE requested a group assignment after the facility assignment 
processing for one unit is successfully completed, the next mnemonic , ■. 
name for the next unit will be obtained and an assignment for it will 
be processed. In a group assignment with option "A", all units named 
in the element will have to be acquired successfully or else none of 
them will be acquired for this ACQUIRE statement. During the facility 
assignment for this Absolute Group, if some \mits are successfully 
assigned and then a unit is found which cannat be assigned; the previous • 
assigned units of this group will be immediately released. 

If the ACQUIRE requested a group, but did not specify "A" absolute, 
any or all units which may be successfully asisigned will be acceptable. 
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Thus facility assignment will alter its processing for group acquires 
-accordingly. 

"D" for DIAL is another option of the acquire statement. . This means 
after the unit has been successfully acquired as explained above, 
facility assignment should initiate and completely process a dial 
operation using the dial number contained in the Unit Control Block. 
Note, if this unit is not connected with automatic dialing equipment, 
the console operator will be instructed to manually dial the number 
and indicate when it is completed. If the dial connection cannot be 
successfully completed, it is as if this unit cannot be acquired, thus 
the original environment will be restored and an attempt for an 
alternate unit will be made (it perhaps will have a different number). 

The "X" option is the same as. the "D" option except an external number 
has been specified. The external number is contained in the ACQUIRE 
statement. 

After facility assignment has successfully assigned the unit or units 
(with successful dialing, if specified) the UCB or UCBs will be linked 
out of the designated file code positon of the task addendum. If a 
unit or units were previously, assigned to this file code, the newly 
acquired units will be linked following those previously acquired. 
It is at thist ime when a successful status will be returned to the 
requesting program. 



RELEASE-. 

RELEASE is the releasing or making available of a previously acquired 
unit or units. The present user has no further need for a communication 
unit, so. it is released, another user executing an acquire may now have 
this unit assigned to his program. 

•Facility assignment routines perform the necessary software functions 
to execute the RELEASE, Returning control back to the user after the 
release is complete. 

Facility assignment uses the file code to obtain the address, of the 
Unit Control Block which is to be released. The communications unit 
usage list (in Facility Map) will be searched for a UCB address 
equal to the one being released. When it is found the other word in 
this entry of the usage list provides the pointers to the Hahdler 
Initialize Descriptor and Unit Descriptor. 

The unit usage entry will be cleared. The Handler Descriptor may be 
located "by following the pointer through the Handler Initialize 
Descriptor. The Handler Descriptor number of users count is decreased , 
by one. If it is now the handler core address will be cleared in 
the Handler Locate Descriptor and the core occupied by the handler will 
be released. Note, this handler will have to be reloaded if some 
latter "ACQ" requires it. Now the other pointer will point to the 
Unit Descriptor, the unit Will be marked as available and the CTM 
Descriptor will be located. If this is the lest tinit using the CTM, 



both the UCB and GTM CB will be released, the CTM will be marked as 
available with no users. If other units are using the CTM, the 
CTM CB-UCB-UCB chain linking will be reformed to eliminate the UCB 
which is being released, then the UCB core may be released. Previous 
to the release of UCB core the file code to UCB chain will be 
reformed, eliminating the UCB which will be released. This will 
complete the RELEASE for one unit. If the RELEASE command specified 
the release of all units on this file code, the next UCB address would 
be located and this unit, would be released. When the requested unit 
or units have been released control will be returned to the user 
program. 



8.9 Illustrative Example Interface Level 2 

This section consists of a User Interface Level 2 example. 
Actual user commands are shown along with a Isrief description 
of the software functions performed as a result of these 
commands. The main purpose here, is to illustrate the message 
and control paths and at the same time present the overall 
Level 2 picture. 
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Figure 2 Explanation 

The hardware, software and User Programs shown in Figure 2 will 
be used as an example to explain how the Software System functions • 

LEGEND AND LISTING OF COMPONENTS 

HAKDWARE 

*"U^' Send-Receive Communication Units connected by direct 
wire capable of being polled. 

•"CTM" - Input/Output Communication Terminal Module 



SOFTWARE 

•"CTM CB" - A table, one per CTM, containing information 
pertaining to the CTM. 

."UCB" - Unit Control Block. A table, one per Communication 
Unit, which contains information pertaining to the 
unit. 

•"ESI Control** - A routine which controls the hardware 

directly. It does this as per instructions 
received from the Communication Handler,' 

♦"Communication Handler Initialization" - A routine which 

will perform intializing and setup operations 
for the Handler which are required only during 
initialization, 

•^^Gommuni cation Handler" - A routine which drives or controls 

the CTMs and their communication units. Polling, 
accepting input, sending output, editing, 
translating, packing and unpacking the messages, 
and transferring the messages to and from the 
Communications Director are its functions. 

•"Communications Director" - A collection of routines which 
together perform the following: 

1 . Queuing or staging of the input and output 
messages on the Random Access Storage. 

2. Interpretation and eventual execution of 
the advanced commands employed by the 
User Programs. 

3. Monitoring for unsolicited input messages. 
Then identifying them and correlating them~ 
with their ultiioate user. 



•"Communication Facility Assignment" - A routine or routines 
which locates Communication Facilities for- a 
User Program, sets up UCBs and CTM CB and 
loads some of the software routines. 

•"Communication Facility Map" - A table, located on mass 
storage, which has a listing of the units, 
the names they may be called by, the handlers 
which should be used, O^CB information, GTM CB 
information and a summary of the units vhioh 
are in us6i 



USER PROGRAMS 

•"Program A" and "Program B" are shown in this example. 
MESSAGES 
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is a message. The A or B is the User Program that it 
is for or from. The second letter I or 
indicates Input or Output message. The third 
letter identifies the conmiunication unit that 
it is for or from. Note these messages are 
stored on drum Queues, 



LINES 



•Solid lines indicate chaining or linking of the various 
components. 

•Dotted lines indicate the transferring of Program Control 
from component to component. 

TABLE REFERENCE 

•The User Programs may not reference anything outside of 
their own program. 

•The Communication Facility map will be referenced by the 
Communication Facility Assignment routine, 

•The Schedule Lists and Unit Control Blocks may be referenced 
, by any of the software routines, but not by the User Programs, 
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Now let us make some assumptions . prior to a step by step explanation 
of the events. 

1 , The Communication Units and CTM^ are available and ready to operate . 

2, Gore memory is completely clear of all Commxinication routines and 
tables. User Programs A and B have not been loaded as yet, 

3, The Communication Facility Map has been set up on Mass Storage 
and has been initialized* All units are available, ppllabie, but ; 
their descriptions are set^ to the poll stop position. 
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User Program is loaded and initiated, it executes an internal: comnand with 
ACQ$-GA, : GHOUP, A - This is an ACQUIRE 

- G = group acquire 

- A = all units, are needed. 

- GBDUP = the name of an element which. consists of the 

unit W and Y mnemonic 

- A = User Program A File Code this group should be 

assigned to* 

"FACILITY CONTBDL" of the Gomm pir is loaded. 

Is' ESI Control in memory. 

NO - Load ESI Control and initialize 

"COM FACILITY ASSIGMENT" is loaded. 



The "GEOUP" is located. 

The "W" mnemonic is located in the COM. FACILITY MAP 

It points to the UCB Descriptor and Handler Descriptor 

Is unit available? - YES 

Form "W" Unit Control Block in core 

List "W" Unit as unavailable in C0M.FA0.S3M. 

From the Unit Descriptor locate the GIM Descriptor 

Is it in core? 

NO - Form the CTM CB N in core 

List this CTM CB as in core 

Place address of CM CBN in UCB-W 

Place address of UCB-W in CTM CB N 

Place address of UCB-W in File Code "A« position of User Prog. A 



Is the Handler in core? 

NO - Load the Handler 

Put address of Handler in CTM CB N 

Load COM HANDLER INIT and execute 

Handler executes a "REQUEST OUTPUT W/O RETURN" for COM CB N 

Output Section of Com. Dir is loaded. 

More units to ACQUIRE? 

YES - "Y" 

The "Y" mnemonic is located in the COM. FACILITY MAP. 

It points to the UCB Descriptor and Handler Descriptor • 

Is the unit available? - YES 

For »Y" Unit Control Block in core 

List "Y" as unavailable in COM. FAC. SDM. 

From the Unit Descriptor locate the C!IM Descriptor 

Is it in core? 

NO - Form CTM CB in core. 

List this CIM CB as in core. 

Put address of C1M CB in UCB-Y. 

Put address of UCB-Y in C!IM CB 0. 

Put address of UCB-Y in UCB-W 

* Notes Two units have now been assigned to File Code A of User 
Prog A. 

Is the Handler in core? YES 

Mark Handler as having another user. 

Put address of Handler in COM CB 0. 

Load COM HANDLER INIT and execute 

Handler executes a "REQUEST OUTPUT W/O RETURN" for C3M CB 0. 
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. Move units to ACQUIRE - NO. . 

. Return to User Prog A with Successful Code 

, HSEKD$AA,# of words, buffer base" - A good morning message is sent by prog. A 

to all units on File Code A. 

The good morning message for UNIT-W will be passed immediately to the 

HANDLER. 
The handler will translate and unpack the message. , ■ ' 
The handler will direct ESI Control to initiate the 'transmission of 
the output message to UNIT-W. 
The handler will test for units to Poll? - NO 
The handler will idle. 
Lv The good morning message f or UNIT-Y will be passed to- the HANDLER. 
The handler will translate and unpack the message. , • 
The handler will direct ESI Control to initiate the tiunsmission of 
output message to unit-Y. 
The handler will Test for units to Poll? NO 
The handler will idle. 
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POLLI$AA," - Start polling for USER PROG. A 
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POLL section Com Director in core? NO - Load it. 

SetUCB-W to poll on position 

Will handler get control again? 

lES 

NO-Q REF Handler for COM CB N 

Is there output for this - G^ GB? 

lES 

NO - Is there input for this CIM CB? 

YES 

NO - Are there units to poll? 

NO - the handler will IDLE 

YES - POLL unit 
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m - other units to POLL? 

NO - Handler win time delay itself 

After time delay 

YES - Input message is coming. 

ESI Control will pass message to the Handler 

Handler will translate and pack the message 

Handler passes input message to Com. Dir. 

Is the Receive section of Com. Dir. in memory? 

YES 

NO - Load Receive section 

Queue this input message on drum with it linked out of UCB-W. 

Return to normal handler cycling. 

Send routine will transfer output message tram. GTH output drum queue 

to the handler. 

The handler will translate and unpack the message. 
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The handler will direct ESI Control to initiate the transmission 
of the output message to the unit. 
Return to noimal handler cycling. 

* NOTE The above handler cycling will continue as long as 
input, output or polling operations are needed. 

Set UCB-Y to poll on position. 

Will handler get control again for-CTM CB 0? 

less 

HO - QRSF Handler for CTM CB 

* The handler cycling explained above will also be initiated for 
CM CB . The same re-entrant handler coding will be used but 
different CTM GBs and UCBs will be referenced. Thus multiple' 
handler cycles may be in process concurrently. Even running 
concurrently with User Programs ^d some portions of the Comm. 
Director. 

^. "BCy$AA,# of words, buffer base," For User Prog. A. 

. Receive routine in memory? 

. NO - Load it. 

. lES - Get a UCB address from the File Code A position of the Task 
Addendum. 

. Was the RECEIVE Commaniof the GENJ^AL type? 
T-YES • ■ 

^ NO - Is the minor File Code number equal to this UCB position in the 

UCB chain from the Task Addendum (01 = 1st UCB)? 
^ lES 

. NO - Is there another UCB in the TA-UCB chain? 

r-. NO 

lES - GET the address of the next UCB ' ,' 
-r Return 

Is there an input message queued against this UCB? 
7- YES 

. NO -* Is there another UCB in the TA-UCB chain? 
h NO ' . ■ 

YES - Get the address of the next UCB. 
Return 
% ■ Return to User Program with Unsuccessful Status 
(^ ' > Is there an input message queued against this UCB?, 
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U NO 
. YES 



-*. MOVE the queued message from the UCB queue to the User Prog buffer. 
. Heturn to the User Prog with Successful status 

* Prog. A may now continue oh its merry way Sending and Receiving 
from either or both of its communication unite*, The polling of 
these units \ti21 also continue. 
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Omega Selection recognizes User Prog. B. Job. 

Omega Selection may cause some of the previous communication routines 
which are not now being used to be dropped from core memory, . 

User Prog. B is loaded into memory. 

ACQ$- ,NAMEX,B - ACQUIRE Command executed by Prog. B 

• This Acquires I3HIT X similar to the previous with some exceptions. Such 
as only one unit was requested and it was specified by a UNIT NAME rather 
than by a GEDUP NAME. This eliminated the locating of the GROUP defining 
element. Also note some of the routines will not have to be loaded 
since they are already in memory. ** 

|«ACQ$- , NAMEZjB" - ACQUIRE Command executed by Prog B. 

. Same as the ACQUIRE for UNI T-X except the UCB-Z address is written . 
into UGB-X rather than into the Prog. B task Addendum. This has formed 
a 2 unit chain. File Code B01 refers to UNIT-X and File Code B02 
refers to UNIT-Z. 

"P0LLY$^B/01," USER PROG B. 

. This will set UCB-X to the poll on condition. The handler will not 
have to be started since it is already cycling for Prog. A. On the 
n ext poll cycle it will poll both units. 

"TRANFERT%B/01," - Transfers UNIT-X from Prog B to .the Comm. Director. 

. The UCB-X address is written into a Task Addendum type location in 
the Comm. Director. 

. The TA-UCB chain position of UCB-X is cleared to indicate it is now 
an end of chain unit. 

. The UCB-Z address is written into the Prog. B. Task Addendum File 
Code B position. 

. Note UNIT-Z file code identification has just changed from B02 to B01, 
its position on the TA.-UCB chain has changed. 

"P0LLY$aB/1" User Prog. B. 

"SMD$aB/1, # of words, buffer base" 

Certain timing conditions would have pezmited thd operations which were 
explained above. To place the hardware i software and User Programs in 
■ the state as shown in Figure 2. 
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9.1 LOADER 



9,1,1 General Description 

The Loader is a processor which provides a flexible -and efficient means of 
collecting independent relative binary (RB) elements to produce an absolute 
object program for execution as a task under control of Omega. An RB element 
is an intermediate output code generated by all system compilers as a result 
of translating a group of source language statements. An RB element is not 
executable but may contain references ( external references ) to other RB 
elements and may itself contain a definition ( external definition ) which is 
referenced by another RB element. The Loader may serve to join RB elements 
generated from source statements expressed in FORTRAN, COBOL, Assembly*, 
language, etc. The process of joining RB elements is called collection . 
The Loader does not actually load a program into memory for execution but 
constructs the entity which may be read and executed. This organization 
facilitates compilation and debugging of small parts of a total program 
and combination of these individual parts for execution with recompiling 
the entire set of individual parts. An absolute program is an entity with 
no unresolved references which can be read in and executed. It may be read 
into any memory area for execution without modification of instructions. 
Its relocatability is inherent from the relative index register luid its 
device independence \d.th regard to system references. The relationship of 
the Loader with the source code and absolute code is shown. 
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Separate elements existing in the job, group, or system libraries 
are collected in constructing an object program. Elements are 
collected on the basis of an external reference in one element which 
can be satisfied by an external definition within a second element. 
The Loader may be directed to include or exclude specific elements 
by secondary control statements, ' 

The basic output of the Loader is an absolute object program. The 
program is entered into the job library under the name specified by 
the user. Optional output includes a list of labels and tags con- 
tained in the program for utilization in testing procedures. Error 
messages and/or a storage layout listing may be obtained as a 
hard-copy record of the collection process. The Loader can also 
transfer the secondary control language as a job library element 
■for subsequent reference. 

The order of user specified elements within a segment will be main- 
■ tained as specifically named by IN.GLUDE statements. All elements 
included by a library search are 'located in the highest level 
segment from which it can be referenced by all elements* 

A starting point is determined during text modification or by an 
ENTRY control statement. Any element may specify a starting addresJs; 
the Loader will accept the first address encountered; 

9»1.2 Primary Control Statement 

The Loader is scheduled and activated in response to a LOAD control 
statement in a job input stream. Information on the LOAD card is 
comprehensive enough to direct the collection and .loading of most 
programs. 



•LOAD - This statement calls for the collection of an KB 
element for processing to generate an absolute object 
program. The format is: 



#LOAD^ options A name/version^^, name/version object, name/version secondary lang<- 

■> tiage 
Name /version RB of element to be collected, .The absolute program 
is identified as name/version ob.iect , ' 

Options are: » 

U - Save the secondary language element in the 'job library. The 
third field of the specifications list is given as the 
element name, 

L - Produce a complete listing. This listing is a summary of 
the memory space used by each element Included in the 
program. The relative location of each external definition 
will also be listed. 

N - Produce no listing. The N option will be overridden if • 
diagnostic messages are to be produced. If neither an H 
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or L option is indicated, sximmary information only will be 
printed, 

I - Accept the program for execution even though errors were 

detected dxiring collection or elements marked as in error were 
included. If the errors prevent the production of an 
absolute program, the Y option will not be effective, 

X - Abort. Do not execute the remainder of the job (i.e., skip 
to next JOB card) if errors are detected. If neither a 
Y or X is given, the event of an error will inhibit execution 
. of the program but will perfom the remainder of the job, ' 

Z - Inhibit the formation of tabular information to be given 
to the test system for test procedures* 

■9*10- Secondary Control Statements 

Construction of segmented programs or particular collections are 
described by a secondary control language which normally follow 
the LOAD statement. The Loader, or utility package can be directed, 
however, to place a set of statements into a job library as an 
element. Subsequent execution of the Loader may utilize this 
element as directed by the LOAD control statement. 

The secondary control language recognized by the Loader allows 
description for even the most complex programs* The user can 
enter these control statements with the input . stream for each 
collection or he can specify a library element of control statements 
to control the collection. 

The control statements recognized by the Loader are INCLUDE, EXCLUDE, 
SEGMENT, ENTRY, and EQUALS. All secondary control language cards are 
blank in column one to distinguish them from primary control cards, 

1,- SEGMENT - The Loader provides a straightforward means of 
constructing overlay segments. For each segment, the user 
.. prepares INCLUDE and/or EXCLUDE control statements to specify 
the relocatable elements to be included within that particular- 
segment. These statements are preceded by a SEGMENT statement 
specifying the name of the segment and its logical origin. 

When a segmented program is called for execution only the main 
segment is initially loaded; There are two ways by which other 
segments may be loaded. The direct method is whenever the user 
. makes a direct call to the overlay supervisor specifying 
the segment to be loaded and the location to which' control is 
to be transferred. The second method is indirect and provides 
for automatic loading of a segment referenced by a jtunp type 
command, whenever the segment is not in core. The mechanics 
for such loading are set up Tsy the Loader and carried out by. 
the overlay supervisor. The Loader, replaces the .address portion 
of the jump command with the address of ati entry vector. The . 
entry vector in turn jumps to the location of theextermXly 
defined sytfibolo If the overlay supervisor is entered, it loads, 
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the necessary segment and transfers control the same as the. 
original jump intended. All registers are preserved by the 
process, and all necessary entry vectors are reset at the 
loading of any segment. 

The SEGMENT statement is "used to declare the beginning of a 
new segment. The format of the SEGftlENT statement isi 

SEGMENT segnamel , segname2 

or 

SEGMENT segnamel , (segnajrie2) ' 

The field segnamel is the name of the segment and must be 
specified. The field segname2 (not enclosed in parentheses) 
specifies that the segment identified by segnamel is to 
originate at the same location as does segname2. (Segname2} 
(enclosed in parentheses) specifies that the segment identified 
by segnamel starts immediately after segname2. If the second 
field contains a series of segment names enclosed in parentheses 
and separated by commas, the Loader sjiarts the segment 
identified by segnamel immediately following the highest 
location occupied by any of these. If the field segname2 is 
void, the segment identified by segnamel is origined immediately 
following the preceding segment. 

Example of Segmentation 

The following example of segmentation illustrates the control 
statements and resultant memory layout. 



#LOAD P, P1 



Comments 

The segment A is origined immediately 
following the preceding segment. 

Comments 



INCLUDE A1 , A2, A3 



SECaffiNT B,(A) 



Identifies specific elements to be 
collected. 

The segment B is origined immediately 
following Segment A. 



INCLUDE B1 , B2 
SECMENT G,B 

INCLUDE CI, C2,"C3 
SEOIENT D, (B,C) 

INCLUDE D1 , D2, D3 
SEGMENT E, D ■ 



The segment G is origined at the same 
position as segment B. 

The segment D is origined following the 
longest of segments B and 0. 

The segment E. is origined at the same 
position as segment d. 



INCLUDE E1 ,E2,E3,Eit 
#tlO P1 
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This particular set of control statements would result in 
the following memory structure « 



Segment 6 



Segment A 



Vector Tables and 
Common Blocks 



Element Acquired from 
Library Searches to 
to Satisfy XBEF'S " 



Elements Specified as Included 
Before Segment Control Statement 



Elements Ai 



Elements Bi 



Segment C 



Segment D 



Elements Ci 



Elements Di 



Segment E 



Elements Ei 
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2.. INCLUDE - This statement allows the user to specify which 
. elements will be cQllected to create a segment.' 

INCLUDE ■ element/version, element/version . . . 

Each element/version field specifies an element to be included 
: in the collection. 

In order to utilize the FORTRAN "block data" feature the 
INCLUDE statement can be used to identify "block data" elements 
(those without external references or external definitions) 
which have initial content for allocated "common" blocks . 

If a "block data" program specifies initial content for two 
common blocks, oni3 of which is referenced in the program being 
allocated while the other is not, the latter is simply ignored . 
by the Loader, If more than one "block data" program specifies 
initial content for a given "common block" the value established 
by the second will be accepted, 

3,. EXCLUDE - This statemisnt is essentially the inverse of the 
INCLUDE. It allows the user to state explicitlyr which 
elements are not to be included in a collection. All RB 
elements implied by the collection other than those excluded 
are accepted, 

EXCLUDE element/version, element/versioa . . . ' 

Each element/version field specifies an element to be excluded 
from the collection. - 

.4.,ENTRI - This statement provides the user the capability of 
overriding the starting address specified via the assembler. 
or the entrance to a main program generated by FORTRAN or 
COBOL. 

ENTRI name ' ; ' .• 

■s ■ 

where name is an externally defined symbol ^ 

5, EQUALS - This statement allows the user to define an external 
reference at the time of collection. 

EQUALS name/value, name/value . , . 

. Eac h name/value field specifies a symbol to be defined and 
the value to be used. Value may be an octal or decimal 
integer, or a symbol ak integer. Such symbols must be 
externally defined by one of the collected elements. 
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6. .Miscellaneous - Primary control statements such as ASG can 
;be submitted as part of the Loader's secondary language. 
jThese. primary control statements will conform to tha normal 
format except for a blank in column one. The Loader vdll 
accept such cards and form them into a block of statements 
associated with the absolute program. These statements 
will thereafter be utilized by Omega whenever the absolute 
. program is named for execution. By this means , for example , 
the ASG statements necessary for efficient selection and 
execution of the program can be penaanently declared and 
associated with the prograia.^^^ : • v, 
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. The following code must be generated by system compilers as an KB 
element. The basic order and structure is retained in the libraries 
and on external media. An KB element is composed of a preamble and 
text sections. 

Preamble 

Preamble is a table of arbitrary length consisting of six distinct 
lists: Header, Entry Definition List, Externally Referenced Name 
List, Control Counter List, INFO List, and optionail Symbol Definitions. 
The Header is always present and indicates the presence and placement 
of the remaining lists. 

9*1 -^ •I .Header 
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Increment to EDEF 


■ 






# of EDEF' 


Increment to XREF 
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Increment to CC | 


1 1 
j . # of CC 


■ 
Increment to INFO 


1 # 1^0 


Increment to SDEF 
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1 # SDEF 


Increment to TEXT j 
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Length of TEXT 
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3 

5 

6 

7 

8 

9 

10 

11 

12 

13 

U 

15 



where - Word ^ is an RB indicator and an error indicator of 



compilation. 



N - N is a 1-10 character alphanumeric name left justified. 
V - Y is a 1-5 character alphanumeric version left justified. 

a?Bloii4^^9.1s%.^^ *^® inci^ments from the file base to the 

'■"' . a. ^ t*.- . „ ... .. 



Words 5, 7, 9, 11, 13, are the number of entries in each list 
for Entry Definitions (EDEF), External References (ZHEF), 
Control Coimter (CC), INFO statements, and Symbol 
Definitions (SDEF). 

Word 15 is the length of the text. 

Entry Definition . Used to mark points within an element which may be 
referenced by other elements. 
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■ N N 
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N N 
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t 




CC ; 


Value 



where N - H is, a 1-10 character alphanumeric name left justified; 
t in bit 2^9th ©f Word 2 indicates whether value is 
relative to a control counter. 2^^"^^ = ±f value 
is relative. 2^9th s 1 if value does not require 
relocation. 

CC for t = i2l is the number of a control counter, the 
beginning value of which is to be added to the entry 
definition value. 

Value is the 15 bit value defined for the named enter. 



Externally Referenced Name Entry . Contains a list of labels or tags 
referenced, the definition of which is not contained in the current element 



ijpMu.uj.od.uii WJLJLJ. w^ uis^^ &>w wwo^ewwiwii •Dime cy inclusion oi necessary 
elements to satisfy references. The number is implied" by position of . 
entry in list « 



N- 
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N 
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N 



N 



N 



N 



where N - N is a 1-10 character alphanumeric name left justified. 

Control Counter Entry . Specifies the noHaber of consecutive words, of. 
core required by code operating under control of this counter. During 
load process control counters are fixed to the starting address of 
assigned area. Control counter number is implicit by order within list 
etfiirting with zero. 





^ of words 



9.1-9 



Information Entry (iNyp) . INFO statements describe areas of coaimon 
oore storage between individual compiled elements* 
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N 
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• N 
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N 




N 
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GN 


CO 
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2 



where N-Nisa1-10 character alphanumeric name of common area 
left justified. . 

\ CO. is the niamber of control counter giving its size. 

GN Group number = Named Common 
Group number = 1 Blank Common 

Symbol Definition Entry . Contains an optional list of labels and 
and tags within element used for diagnostic purposes. 
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where N - N is a 1-10 character alphanumeric name of symbol left 

'J uJ& W.^A ^fe £ W4 • 

CC is control counter number, to which this symbol is 
relative * 

. Value is relative address within control coimter of symbol. 



9.1.4.2 Text 



Each group of element text is H words in length and composed 
of two sections of variable lengths data words, unmodified 
instructions and/or constants appear from right-to-left from 
end of image. Modification infonnati on extends from left to 
right in an uninterrupted stream of bits which specify the 
modification required to load assocated indicated data words. 
The modification inf oimation determines the number of data 
words contained in image . 
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Modification Information . Determines any modification of data 
words, the loading address at which one or more data words are 
to be stored and the starting address of an element. 

There are four cases of major control in the bit stream from . 
aja initial state • 

■ 00 End of stream: start a new image 

01ap Address: "r" is a reference number of 2-12 bits and 
. "a" is a 15 bit unadjusted address. If r> 511, then 
a + cc(r-512) ii3 start address of element. 

^0 No modification. Load data word 

11m Modify according to the modification string "m» then 
start. ;* 

The modification string for a specific word is a sequence of 
the foiTO 

i1i1 . . . ijZi 

where each i specifies a single modification. All but the last 
modification are followed by a "•1"-. The modification string is 
ended by "0". Thus 00,10 combinations end the modification 
string Immediately. 

^Each instruction modification is of the foim: 

f s t r . ^ 

where *f defines the field to be modified, and is of variable 

length. "0" modify bits 14-0, "1" modify bits 29-15,. 
Ilxxxxxyyyyy modify bits x-y* 

s is sign of modification, "0" for addition, "1" for 
subtraction. 

t is the type of modifier, "0" for control counter, 
"1" for external reference. 

r is a reference number, specifying the number of the 
control counter or externally referenced name toibe ;: 
used. 00 use 0, 01 use 1, 11x use x which is ten 
bits. 

Modification of data words is illustrated by the accompanying 
flowchart.,: ■::■';■:■■•;,";■■■■.,',.■'■■■ 
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9.1.5 General Description of Loader Operation 

The Loader has access to all elements established in any of 
the three basic libraries (Job, Group, System) • The Loader 
processes .the LOAD statement and assumes that the name/version 
in the first field is the basic element to be included in the 
total collection. . • 

All secondary control statements from the primary input stream 
are then processed, building the necessary lists for the 
collection process. 

After all primary control statements are processed a pass is 
made on the table of contents (TOG) of all elements in the ' 
library complex until all elements stated as being included 
via the LOAD or INCLUDE statement are located. The search for. 
the included elements is made in a prescribed manner. The 
elements within the Job library are checked against t^ie elements 
included. Next the elements vdthin any Group library linked ' 
to this job are checked. Finally, if all elements are not 
D.ocated the System library Is checked. 

As the libraries are being checked a list of parameters " , ' 
necessary to retrieve all the external definitions within the • 
library complex is formed. 

If source elements are among those elements stated as being 
included, the source element is retrieved and the control 
statements within the element are processed as if they were • 
entered, via the primary input stream. 

All external definitions from elements in the Job library are 
collected and placed on the Loaders scratch file, (ZH), since 
there is no complete list of Job library elomsnt external 
definitions on the job library. 

The external definitions for the element stated as being 
included are retrieved and established as a .list on the Loader - 
scratch file. These external definitions will be the first 
checked in an attempt to satisfy an external reference. 

All elements stated as being included are then retrieved and 
processed one at a time. Processing external references 
involves the satisfaction of any external reference with the 
external definitions available. If the element containing the 
external definition satisfying an external reference is not 
currently marked for inclusion in the collection it is done 
at this time. The external definitions are checked in the 
following order (Included element EDEFS, Job Library EDEFS, 
Group Library EDEFS, System Library EDEFS) . A list of the 
satisfied external references and there value is maintained 
on the Loader scratch file* 
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The processing of common area definitions involves the 
comparison pf a common area name against those already 
processed. If a name matches, the larger of the two areas 
defined is included. 

A count of the length of all segments is maintained by the 
accumulation of the value of the control counters contained 
in each element processed. 

An automatic load entry is created by each reference that 
crosses from one segment to another subsegment. 

After all elements have been pre-processed, the bases of all 
segments are calculated and a base is assigned to each control 
counter . 

If a secondary output was requested the control statements 
necessary to recreate the collection are put out as a source 

element. 

If the symbol definitions are to be processed, they are read 
in from each element and modified hy the base assigned to the- 
element. They are then placed at a calculated position on the 
scratch file such that they fall at the end of the absolute 
element to be created. « 

The text for each element included is then read in and modified* 
All automatic load entry addresses are assigned at text 
modification time. The modified text is buffered out to a . 
pre-calculated area on the scratch file to form the absolute 
element . 

After the text of all elements has been modified the absolute 
element is transferred to th© job library via the Library Service 
routine in Omega's secondary exec. ^^^^^^^^ ^^^^'; ■ 
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9.1 16 Input Slsmerxt Format 

The following diagrams describe the formats of the elements 
with which the Loader operates to form an absolute element. 
The element may be on ai^ of the. libraries within the library 
complex (Job, Group, System)*. 
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REPRESENTATION OF INDIVIDUAL TOGS (INTERNAL)' WITHIN THE LIBRARIES 
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DESCBIPTION OF TOG CONTENTS 

1. RB ELMEKT (C) 

Word A number indicating a RB element. The lower of this 

word is used for error indication. . 

Word 1-3 A 10 character name and a 5 character version. All unused 
portions of these 3 words are space (05) filled. 

Word 4 An increment from the base of the job library at which 
the element can be found. 

Word 5 U = an index from the increment in word J+ which relates 
the start of the XREFS and also relates the length of 
. the EDEFS 

L = index to start of the' cc and relates the length 
of the XREFS 

■ Word 6 U = index to start of the INFO and the length of the cc 

. L - index to start of the SDEF' and the length of the INFO- 

Word 7 L = index to start of the text and the length of the SDEF 

Word 10 Length of the text 

2. ABSOLUTE ELEMEM" (B) 

Word U = Absolute type number (2) 

L = Error indicator 

Word 1-3 Same as in RB element 

Word 4- Same as in RB element 

• Word 5 U = the maximum amount of core utilized at any one time 
,. Ijs liagth ef eentrel §@gffi®at 

;^jqpjj ^ . U = number of segments . 

L = number of ASG images . 

Word 7 ' ' L=the number of SDEFS 
• Word 10 Index to SBEFS - : 

3. SOURCE ELEMENT (A) 

. Word .- U = source type number (3) 

L = Error indicator 

Word 1-3 Same as in RB- element 

Word 4 Saiae as'in RB element 
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Wprd 5-6 Unassigned 

Word 7 . U = a subtype indicating type of source code 

A = normal (20 word card image) B = compressed source 
L = the number of images within the element (compressed or 

normal) 

Word 10 Total element length 
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RB ELEMENT FORMAT DESCRIPTION 



1. EDEF - A three word external definition which defines an entry point 

within the element or some value defined by the element. It 
consists of a ten character name and a 15 bit value. If the 
value is absolute, the sign bit will be set (T) and no control 
counter (CC) will be present, GC defines the control counter 
to which this value is relative* 

2. XREF - A two word external reference which will be satisfied by an SDSF, 

3. CO - A control counter which defines the amount of core occupied 

by the data under that control counter, 

4., INFO - A three word item defining a common area. The name of the 

common area occupies the first two words, GN is an indicator 
indicating the type of common, = named common, 1 = blank , 
common. The control counter under which the common is to 
appear is defined in the lower, 

5 . SDSF - A three word item defining a position within the element 
which can be used in debugging procedures. It has the 
same format as an EDEF. 

6* TEXT - Text is grouped into a number of 14 word images which contain 
modification and instructions. 
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ENTRY POINT TABLE FOR GROUP AND SYSTEM LIBRARY 



N N .N N N 
N N H N N 
T eg VALUE 



gg77 7 



IND TO TOG 



ELMENT EDEFS 



REL TO BASE OF TOG, Upon 
use in the collector loader 
this value is used to find 
the toe associated with the 
particular EDEF. 
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9.1.7 Basic Functions of Loader Phase 1 

A. Inputs 

1. JOB, GROUP, SirSTM LIBRARIES 

2. CONTROL CARD AND/OR MAP ELEMENTS , 

B. Output Tables and Lists 

1 . INCT (Include table from INCLUDE STATEMENTS AND LOAD STATEMENTS) 

2. SNT (Segment Name Table from SECMENT STATEMENTS) 

3. SMAP. (Segment map showing relation of segment 

bases as defined by Segment statements) 

.4. EQUT (Equals Table from EQUALS statements) 
5» EXCT (Exclude Table from EXCLUDE statements) 

6. ENT (Entry definition name from ENTllY statement) 

7. ATOC (The table of contents of all items in the INCT 

table) 

8. ED (A list of parameters required to find all EDEFS in 

the system) 

9. Job and Included EDEFS (A list of all EDEFS from included 

elements and the Job library) 

10. Secondary Output v"'^^ secondary output consisting of control 

statements necessary to recreate the " 
collection) 

C. Procedures 

The control statements are read from the primary input stream 
and any source elements included. The above mentioned tables and 
lists are constructed from these control statements and the 
elements from the libraries. 

The tables and lists built ' are described below. 
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SEG# 



LOADER (PHASE 1 INTERNAL TABLES) 

(ATOG TABLE) 



I ORDER COUNT 



N N 
N" N 
V V 



N 
N 
V 



N N 

N N 

V . V 



INC TO ELT BASE 



INDEX TO XREF 



INDEX TO INFO 



INDEX TO CC 



INDEX TO SDEF 



INDEX TO TEST 



LENGTH OF TEXT 



. TOG DRUM INC (IDENTIFIM) 



ATOG is a revised TOG table which is 
the main output of Phase 1 . This table 
will include an entry for each element 
to be included in the collection process 
except those elements included because 
of an external reference. The segment 
with which the element is associated is 
indicated in the upper of word 0, The 
order count is a number representing 
the order in which this element is to be 
included* 



N N N N 


N 


N N N N 


N 


LENGTH 


BASE 





(SNT TABLE) 

SNT (Segment Name Table) is a list of 
segment names taken from SEGMENT cards 
encountered. A 3rd word reserved for 
the segment length and base is added. 
This table is related to SMAP in that - 
the procedure for assigning a base is 
dictated by SMAP. This table is preserved 
through Phase' 3 and a revised version 
is included in output as information 
necessary for the load of a given segment. 



N 


N 


N 


N 


N 


N 


N ■ 


N 


N 


N 



(ent) 

ENT is a two word name representing a. 
starting address to be used as the 
start address of the absolute 
output. This name will -be preserved 
through Phase 2 where an address will be 
associated with the name. This address 
will then be put out as the starting 
address of the absolute element. 
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iN N N N N 
N N N N N 
V V V V V 


SEG § 


CALL ORDER 







INCT 

INGT (INCLUDE TABLE) is a list of all 
elements to be retrieved from the library 
which were specified on INCLUDE control 
cards. ■ Seg # indicates the segment in 
which the specified element is to be 
placed. CALL ORDER indicates the order 
in which the elements are to be processed. 
INGT is a temporary table esdsting ojily 
through Phase 1, 




EXCT 

EXCT (EXCLUDE TABLE) is a table consisting 
of all elements specified on EXCLUDE 
control cards. This table exists only 
during Phase 1 . Seg # indicates the 
segment in which the exclude statement 
applies. 



N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


NE 


m 


NE 


NE 


NE 


InE 






NE 


NE 


3 












4„SEG 


i 






INC 





EQUT 

EQUT (EQUALS TABLE) is derived from the 
content of EQUALS Card. The first two 
word name is the name to be equated. The 
2nd two word name is the EDEF being used 
to allocate words 0-1 . An indicator is 
set as these are satisfied » This table 
exists until Phase 2. 
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9.1.10 collector/loader' table transition 



BDTOC 



iV 1 


Error Ind 


N N N N N 
N N N N N 
V V V V V 


Increment to ELT Base 


Index to XREF 


Index to CC 


Index to INFO 


Index to SDEF 


Index to TEXT 


Length of TEXT 



>o 



t 
hi 



BDTOC is created in. Phase 1 diirlng a pass on. the system toes. Its purpose is the processing 
of block data after the common area bases have been determined. It is preserved to Phase 3 where block 
data is processed. 

The sign bit in word ^ of the toe indicated a block data element. A block data element will 
contain no SDEF s or XREFs. ' . . 

Block data is processed by comparing the common names of the block data element with the common 
names of the collected elements. If a match is made, the data contained under the control counter for 
.that common area will be deposited in the common area defined. by the collected element. 

If the data length exceeds the common area, the excess data will be discarded. 

Block data can only be assigned to named common not blank common. 



. GODS 


SEG # , 


7 


SEG # 
-7 


CODE 


SEG # 

■ 


7--™ — • — - 


— -"^^ — —7 


! 





SMAP (Segment MAP) is a table of 
variable .length items describing 
the relation between segments in - 
regard to base addresses. It is 
a semi -permanent table that is 
built as the SEQffiNT control card 
is examined. It is retained until 
after Phase 2 at which time the 
length of individual segments is 
known and a complete picture of the 
segment allocation can be determined. 
Referral to SNT is made to obtain 
the known length of segments. The 
base is assigned and placed in SNT. 
Each segment entry is separated from 

the next by a 7 7. The code 

may be any of the following; 

Code 1 Segment base is equal to the 
base of the segment specified 
in the lower plus the length 
of that segment. 



Code 2 Segment base is equal to the 
base assigned to the segment 
specified in the lower. 

Code 3 Segment base is equal to the 
base of the segment specified 
in the lower plus the length 

segment. 
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A 
B 
C 



-FILE CODE 


LENGTH 




FILE I 


NCREMENT 




FILE CODE 


LENGTH 




FILE INCREMENT 


FILE CODE 


LENGTH 




FILE INCREMENT 


7 7 7 .7 


7 7 7 7 7 


7 



ED 



ED (External Definition parameter list) 
defines the location and length of all 
external definitions in the system. EacTn 
entry is a two word entry giving the file 
code under which the external definitions 
can be found. The length of the data, 
and the increment to the file base. 
Normally A would define the parameters 
necessary to read the included elements 
external definitions. B would be for 
the Job library, G would be for a Group 
library or systems library. 

The list is variable in length and is 
closed, out with a word of all 7'Si 
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SOURCE ELEMENT 



N 



# WORDS IN IMAGE 


mGE 


# WORDS IN IMAGE 




1# WORDS IN IMAGE 



Source Element Description 

The source element is used by the LosLder only as an included 
element containing more secondary control statements necessary * 
for the collection* 



Word . 

. Word 1-N 
Word N 



Defines the size in words of the iioage 
following word 0* 

The variable length image • 

Same as word 0t 
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9.1 .8 • Basic Functions of Loader Phase 2 

A, Inputs 

■ 1. Phase 1 Tables and Lists (ATOG, SNT, EHJT, StUAP, EQUT, 
EXGT, ED, collected external definitions for included 
elements and Job library) . 

2. Entry Point Lists From Group and System libraries. 

3» Lists within included elements (3CREFS, CO, INFO, SDEF). 

B» Output 

1. ATOG (Updated from Phase 1, with additions and changes) 

2. GG (List of control counters with assigned bases for all 

elements in the collection) 

3. SXREF (List of all XREFS from elements along with 

assigned addresses) 

4. INFOT (List of all comman area definitions from all 

included elements along with assigned bases) 

5» ALE (List of all cros segment references which will go 
into the yector table of the absolute element) 

6. SDEF (Symbol definitions with address modified and placed^ 
on scratch file) • 

7* XREFsand GG (A modified list of satisfied XREFs and 

control counters broken down to 1 word each) 

G. Procedure 

The items are extracted from ATOG and all external references 
satisfied by external definitions. If cross segment references 
are found an ALE item is produced. If the element referenced 
is not included it is added to the end of ATOG for later 
processing. 

• 
Common area definitions are summarized in INFOT. After all. 
elements in ATOG have been processed, a pass is made on all 
control counters and satisfied XREFs assigning bases and 
addresses. The intermediate and output tables and lista 
are described below. 
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Loader Phase 2 Tables and Descriptions 
Internal Tables 

ATOC, SNT, ENT, SdAP, EQUT (From Phase 1) 
Intermediate and Outputs Tables 



N 

N 
T 


N N 
N • N 
CC 


N 
N 
VALUE 


N 
N 




7 






7 


TOG DRUM INC (IDENT) 



EDEF TABLE 

The EDEF table is a collection of 
all EDEFs from all elements within 
a particular library. EDEFs for 
use and system libraries are 
already grouped in an ENTRt POINT 
TABLE. EDEFs for the JOB are 
collected during phase 1 while 
the, INCLUDE statements are being 
processed. If insufficient core 
storage, the EDEF lists are buffered 
in and out. The EDEF table- is used 
to satisfy external references of 
the included elements* 
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Afjju axj.u juj 



N 


N n 


N 


K • 


H N 


N 




GN 


YALUi!) 



^ 



N 
N 
SEG# 



N 
ORDER 



N 



INFO ITM 



ALB ITEM 



The ALE and INFOT table items are intermixed with the INFOT item having 
the sign bit of the third word set to distinguish it from an ALE entry. 
The value in the INFOT itein repressr 

name. Blank common is represented as having a GN of 1. 
area occupies the same area regardless of name, - 



th© largest common area of the same 



Ar^ blank common 



The ALE entry will eventually be used to produce the segment jump 
table. . The third word defines the position within the segment jump table for 
that entry. ^ ,■ ^ .,,..'■',■:,;.■•.'■ ' 
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S^OffiF TABLE 



CO 



N 



N 
N 

TU CC 

ALE LINK 



N 1 
N 1 

VALUE 

TOG LINK 



INFO LINK 



VALUE 



VALUE 



The SXREF table is created upon the satisfaction of external reference 
by an external definition. T=1 if value is absolute, U equals 1 if 
XREF was unsatisfied. The ALE link is a link to an automatic load 
entry table item. It is present when the reference is such that a 
segment load is necessary before the transfer can be completed during 
execution. The TOG link is a link to the ATOC table item of the. 
EDEF satisfying that external reference. 

The GCs associated with the element are also processed to some extent* 
A control counter not associated with a common area is simply moved 
without charge. A control counter associated with a common area has . 
a link to the INFO item defining this common area. 

Aftsr iash sliment is proeegsed in phase two the abdvo, i&fomatie& i§ 
buffered out to mass storage and the TOO (A^C) table updated with the 
necessary information. 
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EXCT 




EXCT is built during Phase 1 frora names on exclude cards. ' It is preserved through 
.Phase 2 where the EXCT table is checked before a toe is added to the ATOC table. It 
indicates what elements are to be excluded from the collection. 



>o 






B 



EQUT 



N 
N 
NE 
NE 



N 
N 

NE 
NE 



SEG # 



N 
N 
NE 
NE 



N 
N 
NE 
NE 



ME 



INC 



N 
N 


N N N 
N N N 


N 
N 


n r- 











ALE 


LINK 


TOG LINK 


TV 


CC 


VALUE 



EQUT is built during Phase 1 from information on equals cards. During Phase 2 the 
reference (NE) is satisfied and the item is modified to appear as in B, This table is 
then used to satisfy an XREF that cannot be satisfied by an EDEF. 



vO 






CCTI 




EDEF OF INCLUDED ELEMENTS 
AND JOB LIBRARY 



SATISFIED 
and GCs 



XREFS 



DRUM LAYOUT 



XREFs and 

CO with assigned base 

Right before Phase 3 



Instruction 
Storage Durin| 
Phase 3 



Secondary 

Output 

Images 

Created 

From 

ATOC 

If 

Requested 



SDEF STORAGE • 
If SDEF Output Requested' 
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9.1-,9 Basic Functions of Loader Phase 3 

A* Inputs 

■1. Phase 1 and 2 Table, Lists (ATOG, ^3[REF AND CG LIST, 
SNT, INFOT, ALE)i 

2. TEXT form included elements, 
B, Outputs 

Absolute element on scratch file. 

G. Procedures 

All items are extracted from ATOC in reverse order, 
(control to last segment), and the text, modified XREFs 
and CC's for each element are read into core. The text 
is modified as indicated by the modification and buffered 
out to the scratch file area reserved for the element. 
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A 



B 



ATOC 



SEGMENT # 



ORDER COUNT 



N 
N 
V 



N 
N 
V 



N 
N 
V 



N 
N 
V 



N 
N 
V 



INCREMENT TO ELT 



INDEX TO XREF 



INDEX TO INFO 



INDEX TO CC 



INDEX TO SDEF 



INDEX TO TEXT 



LENGTH OF TEXT 



IDENTIFIER (TOG DRUM INC) 



SEGMENT # 


COUNT 


N N N N N 
N N N N N 
V ¥ V V V 


INCREMENT TO ELT BASE 


INC TO CC 


INC TO END ■ 


DEC FROM EQTB 
BASE 


INDEX TO SDEF 


INDEX TO TEXT 


LENGTH OF TEXT 


IDENTIFIER I (TOG DRUM INC) 






SEGMENT #" 


COUNT 


1 
2 
3 


N N N N N 
N N N N . N 
V V V' ¥ ¥ 


K 


INCREMENT TO ELT BASE 


5 


# XREF 1 CORE BASE 


6 


DEC FROM EQTB INDEX TO SDEF 
BASE 


7 


f INDEX TO TEXT 


10 


LENGTH OF TEXT 


11 


# CC CC BASE 



\0 



vi. 



(a) ATOG is originally produced from the system toes that correspond to names on include cards, 
An identifier is tacked onto the end which is used to identify the element from which an 
EDEF was obtained. If more elements are retrieved to satisfy XREFs the toes for those 
elements will be added to ATOC. : - . 

After Phase 1, as the XREFs are processed in Phase 2, the ATOC item is modified as in B. 
■The satisfied XREFs and CCs are buffered out to the drum and information necessary to 
; retrieve them is supplied. The information is relative to a file increment known within 

:. the loader, -,''■' .'■■■,■■ - ,. :-. ; :v 



Upon entrance to Phase 3 the ATOG item is in the form defined by C where word 5 has 
been modified to relate the number of XREFs (1 word) and their location. Word 11 
relates the number of CC and their location. .' * 



SNT 







A (Phase l) 




N 
N 


N 
N 


N N 
N N 


. N 
N 




• 



B (Phase -2) 



N 
N 



N 
N 



# ENTRY POINT 



N 
N 



BASE 



C (Phase 3) 



N 
N 



N 
N 



LENGTH 



SNT Is initially built during Phase 1 and goes thjrough a series of changes until it eventually 
ebtains the final form described in C, where (length) defines the length of the particular segment 
and (base) defines the relative core base at which segment should be loaded,. 



>o 






ABRIDGED SXREF AND CG LIST 



TIU 



VALUE 



BASE 



• INFO LINK 



LENGTH 



XREF 

GO (TEXT) 

CC (CCMION) 



All XREFs for each element are 
assigned the actual address and 
are broken down to 1 word. The 
status bit setting in the upper 
and the value in the lower. All 
control counters for text have 
the assigned base in the lower 
half word and the upper half is 
clear. Common area control 
counters have a link in the 
upper to the IMFOT item where 
the common area length ma/ be 
found. 
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ABSOLUTE EI.EMENT FORMAT 



ASSIGxN^ 
IMAGES 



ENTRY INSTRUCTIONS 



FG 



LENGTH OF SEG 



REL GORE BASE 
OF SEG 



DRUM INC TO SEG 



77777777 7 7 

7 7 7 7 7 j ENTRY ADDR 

ENTRY ADDR I OF 7 7 7 7 7 



f 

) 



1111111111 



COMMON 

AND 
CONTROL 



^ N 

i N 

SEG NO. 



N 
N 

VALUE 



10 
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ABSOLUTE ELEMENT FORMAT DESCRIPTION 

1, ' ASSIGN IMAGES - Images used at load time for facility assignment, 

2. ENTRI - The initial word of the element that will be placeS in core 

at load time. The start address of any element will be the 
base of the element. If the starting point is in a subsegment 
the entry instruction will be a jump to that entry point in the 
segment jump table. 

3* SEQUENT LOAD PACKET - A segment load packet defining the file, ■ 

length, base, and. increment to the particular 
segment. There is one, three word packet for 
each segment in the collected element. 

4. 7777777777 - A sentinel to signal the end of the segment load packets, , 

5» 77777 X - A sentinel signaling the start of the segment Jmnp 

table. The lower contains a link to the segment load 
packet for that segment containing the entry points. 

6. ENTRY ADDR.- The upper of this word will always contain the entry 

point address. If that segment is presently in core 
the lower will contain the same address. If that segment 
is not in core the lower will contain 77777 which will 
cause a guard mode interrupt when an attempt to reference 
it is mads. Upon a guard mods interrupt control will 
be given to the segment loader and the segment referenced 
will be brought into core. The jump table will then be 
updated by the segment loader in such a way that any 
segment destroyed by the new segment will have its 
entrance address set to 77777. 

7. 7 7 - A sentinel indicating* the end of the jump table, 

8. COMMON AND CONTROL - The part of the element that is resident in 

core for the life of the element. It contains 
the control portion plus all common areas defined, 
plus any routines collected to satisfy undefined 

.XREFs. 

9. SEGMENTS ■- Segment storage 

1 • SDEF - Symbol definition list with assigned values . 
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INSTRUCTION MODULE FORMAT for U90 COLLECTOR OUTPU'r 



The instruction modules that the loader produces consist of 
five modification words and 113 instructions. The modification 
appears, left adjusted, in the first five words of the instruc- 
tion module . Each of the 113 instructions require two bits of 
modification code, MC. Instructions start in word six of the 
module. 



Word 1 I MG1 



MC2 MC3 



Word 5 
Word 6 



MC20 
MC37 
MG56 
KC75 



MG21 



MC113 



INSTRUCTION NUMBER 1 
INSTRUCTION NUMBER 2 




Word 120 



INSTRUCTION NUMBER 113 
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9.2 Library Maintenance Functional Description 



Library maintenance consists of four basic operations; IN, OUT, 
PRINT, and LINK. ■ INs function is placing an element onto the 
Job Library. The operations are initiated by a control state- 
ment. Upon receiving a job number and a control image, IN scans 
and extracts the different fields. The option field is master 
bitted and then used as a switch. The Name/Version fields are 
extracted according to valid control characters and checked for 
their length. After extraction the job directory entries (p, ) 
are accessed from the job library. The previous job n\imbers in 
the directory are compared with the current number. A success- 
ful comparison enables the linking to: any prior TOG modules. 
The TOG (Table of Gontents) contains a residing element^s 
name/version, logical drum address, and indexes. The current 
name/version from the statement is cross referenced against the 
TOG. With a mismatch, IN starts' buffering in a new element from' 
either the primary or secondary source. As the IN function con- 
tinues, there is a buffering out of the element onto mass storage. 
The storage has been assigned to the element through the use of 
the master storage directory (p. ) • The incoming TOG is up- 
dated by entering a logical drum address. The TOG and its ; 
element are now linked together. The new TOG is then moved to 
a new or prior TOG module. The final operation in placing an 
element onto the library is updating the job directory and TOG 
module. With each successive element, the pre-described events 
are repeated. Upon exhaustion of either the primary or secondary 
input streams, the function returns control back to the system. 

The OUT function is initiated in the same manner as IN. OUT scans 
and extracts the different fields from the control image. One 
mandatory field is the library name (JOB, GROUP/ iilB # or SYS.*), 
Without this field, the function would be unable to determine in ■ 
which library a specific element resides. Also, the field is 
necessary for the interpretation of the specified format of each 
library (p. ). TOG modules are accessed from one of these 
libraries, Gomparison of name/version from the statement with the 
related TOG establishes which element is to be processed. 

From analyzing the option field, a switch is set determining whether 
a secondary or primary output is required. With the type of output 
and TOG known, the function choses one of three avenues in the pro- 
cessing of a specific element type. The avenues are associated with 
the element type: relative binary, absolute or source (p. )• 
If the switch is set for primary output, the function transfers each 
element in 20g word card images. With the exception of source, two 
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words of any 20g word image will have a sequence name and number 
(p. ). For tape output OUT sets up a header, data, and end 
sentinel block (p. ). The header block contains the TOG, The 
remainder of the element resides in the data blocks. Each data 
block contains specific number of l6rt word images. Images will 
not have a sequence name and number. Each element established on 
a tape contains these basic blocks. 

An element's TOG. and preamble contains .yital informati^ij^^^^RINT's 
task is to submit that information to primary output printer. FBINT 
has OUT'S method of retrieving a specific element from a library. With the 
retrieved information PRINT checks for a ^T} option. If present the 
function prints the TOG. Otherwise, the TOG and preamble are both 
printed. The next logical event to occur is detennining a element format. 
Once established, the TOG and preamble are printed in the preceding foriiLS. 

BELATIVE BINAHX ELMENT 









TABLE OF GONTEaJTS 








BINART 


ELEMENT 


NAME-LMO 




VERSION-ONE 






EDEF 


XREF 




CC 


INFO 


SDEF 


TEXT 


INDEX 


00000 


00003 




00056 


00063 


00077 


00077 


NUMBER 


00000 


00027 




00005 


OOOOA 


00000 


01526 



The preamble of this binary element consists of entry definitions, external 
references, control counter and symbol definitions. The entry definition 
(EDEF) is a point within an element referenced by other elements. The EDEF 
has 1 to Ij^ character left justified alphanumeric name and has a value 
associated to the name. In the below representation, the GO is" the number 
of a control counter which contains a base increment. The base increment 
plus "VALUE" of the EDEF is the entry or referenced point. If there are 
three or more EDEF the form ie repeated as indicated* 



NAME CC 



VALUE 



GJD 00000 00101 
MAD 00004 00765 



ENTRY DEFINITIONS 
NAME GG VALUE 
SCO 00002 00010 



NAME CC VALUE 
SCOP 00000 00031 



The preamblie contains a list of labels or tags not referenced in the element 
(XRSF). At collection time the external references are satisfied by in- 
cluding the necessary referenced element. The name has 1 to 10 alphanumeric 
characters and is left justified* The NR (nximber) is isrplied by position 
of entry in the list. 
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NR NAME 
00000 



EXTERNAL REFERENCES 
NR NAME NR NAME NR NAME 
00001 SPICK 00002 IDUS 00003 KROK 



The control counter specifies the niimber of consecutive words of core re« 
Quired by code operating under control of this counter* At load time 
the counters have affixed starting address of assigned relative 
area. The NR (n\2mber) is implied lasr a counters position. 



NR 



VALUE 



NR 



CONTROL COUNTERS . 
VALUE NR VALUE 



NR 



VALUE 



00000 00100 
OOOOA 00240 



00001 OOI-IO 



00002 00200 



00003 00210 



Areas common between different compiled elements are described by infor- 
mation entries. The INFO has 1 to 1j^ character edphantameric name. The 
name is left justified. The OG is a number of a counter giving its size. 



INFORMATION ENTRIES 



NAME 

MOCK 
POSH 



cc 

00000 
00004 



NAME 

AKKE 
LOCA 



cc 

00001 
00005 



NAME 
SOSE 



CC 
00002 



NAME 
ZIDE 



CC 
00003 



Symbol definition entry (SDEF) is a label or tag used within an element for 
testing purposes. The base value represented by the CC is modified by a 
relative increment (VALUE) at load time. The obtain relative address is 
an entiy or referenced point used for testing* The name is 1; to 1)Zi 
character alphanumeric and is left justified* 
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ABSOLUTS ELMMT 



TABLE OF CONTENTS 

ABSOLUTE ELEMENT NAME-LMOV 

MAXIMUM CORE USED- 
FJMBER OF ASG IMAGES- 
NUMBER OF SDEF- 



VERSION-ONE 

00200 
00004 
00016 



ASG IMAGES 

/^ ASG ^ H ^ TAPE,A, ,WORK UNIT 
• • • 

ASG images are used at load time for facility assignments 
SDEFs are described p ( }* 



SOURCE ELEMENT 



TABLE OF CONTENTS 
SOURCE ELEMENT NAME-LM01 VERSION-TWO 

NUMBER OF IMAGES IN £L£2{ENT- 00102 



00000 LMO PROGRAM 

00001 CD C0MM0N*100 
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IN OPERATION 

A. Format of Statement 

' ' # IN OPTIONS FG, NAME/VEESION, ETC. 

B. Valid Options 

G - Elements follow in primary input streams 

R - Rewind tape before processing 

X'- Abort job if errors occur 

Y - Continue even if a non-fatal error occurs 



C* Element Specifications 

If no NAME/VERSION is specified all elements contained in the medium • 
specified will be included. The order in which ihe specified element 
will be processed is dependent on the order in which the elements are 
inputted and not on the order of specification on the IN ImaLge. 

FC - File code is present only when no C option 



D. Functional Description 

1 . The initial duty of Library Maintenance upon receipt of an IN 
statement will be to attempt to locate the job within the Job 
Directory maintained as part of the job library. If the job is 
not already established in the directoiy an entiy is made. 

•2. The options are then master bitted and any element names unstrung, 

3« The header of the elements are located and a branch is made on 
the type of element encountered. The proper format is then 
determined, a request for the amount of mass storage needed f.or 
the storage of the element is made, and the element is then 
buffered out to thev job libraiy* 
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CABD IMAGES 

l) Relative Binary Element 

Col. 1 to 'Col. IjZi - Sequence number euad card type 



LMO 



0002B 



12**.. .10 
LMO 0001A 



1:2. . . 
LMO 



10 
OOOOA 



k) Card Type (A) consist of a 1!0G and preamble 
B) Card Type (B) is Test 

2) Absolute Element - In addition to (A) and (B) type the absolute 

element has a third type, (G). The (C) type 
iimage contains, symbol definitions.^ ^^^^^ ^^^^^^^ 

3l Source Element - Source has ^no^ sequence number or card type. 
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OUT OPERATION 

A. Format of Statement 

§ Out options FC, JOB, NAME/VERSION, ETC. 
i Out options FG, SYS, NAME/VERSION , SKJ. 
# Out options FC, GEOtJPAlB#, NAME/VERSIOH, ETC. 

B. Valid Options 

C - Elements to follow primary input stream 
F - Write hardware end of file on tape output 
X - Abort job if errors occur 
Y - Continue if non-fatal error occurs 

C. Element Specification 

Elements will be outputted in the order in which they are located 
in the library not in the order in which they were specified on 
card. If an element NAME/VERSION- is blank, all elements within 
the specified library will be outputted. 

FC - (file code) is present when a C option is absent. 

JOB;SYS;GROUP/[iIB# - is a fixed entry which defines the particular 
library from which the elementCs) are to be takenrfrom.- 

D. Functional Description 

1i The Job is located within the Job directoryt 

2. The TOCS are located for elements to be put out* 

3. The data is formatted in the proper format. 
U • The . data is jput out to the prescribed media • 
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Tape and Drain Formats 






7373737373 


1 


ELEMENT NME 


2 


AND 


3 


VERSION 


k 


DATE 


5 


REEL # 


6 


TIME 


7 


BLOCK SIZE 


10 


ITEM SIZE 





■ 
TOO 


1 


;, , : : . . 


2 




3 




4 




5 




6 


' ■■ , . '• 


7 


' . ■ ■ '' ■ 


10 




30;. 


7 3 7 3 7 3 7 3 7 3 



The initial block of each element 
containa the library ntunber assigned 
to the element. The block size and 
item size will normally be. 306 and 14 
respectively. Each item will normally 
be a 14 word* card image. 

Tape and drum formats are identical. 
If all tape and drum processing is 
handled as drum processing , the processing 
will be identical. 
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Data Block Layout for Elements 




The lower of the first word contains 
the actual number of data words present 
in the block. The upper word has 
number of equal si zed itens contained 
in the data block. If upper half is 
negative, there is no logical item 
size. The last word of the data 
block is the GXSDM. 



On tape and dmim, any desk ID, sequence number and type are dropped 
and only 14- word images are used except in the care of source code. There 
is.no separation of the individual parts of the elements as the length 
of each peo't can be calculated fromi the toc» 
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PEIHT OPEBATION 

A, Format of Statement 

# PRINT- options JOB, NAME/VERSION, ETC, 

# PRINT options SIS, NAMEAERSION, ETC. 

# PRINT options GROUP/[iIB#, NAMEAERSION, ETC. 

B* Valid Options 

T - list TOGS only 

- Print card images contained in named files normally used for 

control streams source code. 

X - Same as #IN 

1 - Same as #IN 

C. Element Specification 

Elements will be outputted in the order in which they are located 
in the library not in the order in which they were specified on 
card. If an element NAME/VERSION is blank, all elements within 
the specified library will be outputted. 

FC - (file code) is present when a C option is absent. 

JOB; SYSj GRDUP/liIB# - is a fixed entry which defines the particular 
library from which the element (s) are to be taken>. f rom.- 

D. IWctional Description 

1. The job is located within the job directory. 

2o The TOGS are located for elements to be put out« 

3* The data is formatted in the proper fonnat* 

4. The data is put out to the prescribed media. 
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LINK OPERATION 

A. Format of Stat^ent 

. # LINK options LIB#, FC, Ptype 

B. Valid Options 

Same as on an #ilSG card 

C. Library Specification 

LIB# is the file name of the desired group library 

» • ■ . ■ ■ 

D« Functions Description 

Libraiy Maintenance will request a file check with MFDR using the 
name/version of the user library. If already present, an indication 
. is given and the link increment returned. If not present, Library 
Maintenance will perform a service request for the assignment of media 
which the requested library resides. The initial block of the library 
is read and a registration request for file extensions is made along 
with the amount of mass storage required. The elements are then pro- 
cessed and place on mass storage. 



9.2-11 



The General Format of the Job Library 



MASTER STORAGE DIR. 


INITIAL JOB DIR. MOD, 


ELEMENT STORAGE 





367276 



GROUP LIBRARIES AND JOB 
ELEMENT EXPANSION 



MASTER STORAGE DIRECTORY 

The storage directory or bit 
map is used in the assigning of 
storage within the job library. 
The bit map occupies the first 
102 octal words of the library. 
"One bits" are set within the 
map to indicate taken areas of 
storage (I' bit = 102g words). 
The storage directory has the 
capacity to show that 367276^' 
octal words of area are avail- ^ 
.able or assigned* 



JOB DIRECTORY 

The directors' contains axial. 
purpose entries. One entry 
establishes the linking of nob 
numbers to their associated 
elements. The second entry 
affixes the linking of group 
libraries with individual j obs . 
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The Job Directory 

The initial job directory occupies logical addresses 102-203 of the 
job library file. It serves the dual purpose of linking job numbers to 
their associated elements and of linking group libraries with individual 
jobs. The job entry is one word in length. The last word of the module 
contains the remaining number, of cells within the module and a link 
address to the next module. The library link entry has the sign bit 
set to distinguish it from directory entries. Upon a reference #0 a . 
group library, a search is made of the user library links and entries . 
with corresponding job numbers will apply.- The group library number is 
an identifier to distinguish between group libraries. 



JOB 1 



JOB 2 



JQB_1 



INC TO LAST TOCM 



INC TO LAST TOOL 



INC TO .GROUP LIB. 



GROUP LIBRARY NUMBER 



101 



# ENTRY 



g( OR LINK NEXT MOD> 
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LIBRART MAINTENANCE STORAGE DESCRIPTION 



A basic area of prime mass storage is used to pool data involved 
with a number of jobs. Any extension required due to the overflow of 
the basic area will be restricted to the job associated with the 
request causing the overflow. Any group library established will 
cause the extension of the job library file. If possible the extension- 
for a group library will be made .on non-prime mass storage. Upon the 
termination of a job, the area within the basic mass storage will be 
released to library maintenance. Any extensions associated with the 
job will be released to the system. A group library extension wiH 
remain accessible as long as an active job is associisited with it. A 
non-active group library area will be released to the system if the 
area is needed. 

The extension of the job libraiy are made through a Master File 
Directory Routine (MFDR). The MPDR will maintain a directory with 
an entry for each file along with logical and absolute addresses of 
the file* A count of the number of Jobs using the group libz^iry 
extension is maintained. 
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MASTER STORAGE DIRECTORY OR BIT MAP 



The bit map occupies the initial 102 words of the job library. The 
first 100 words are taken as a 100 by 36 grid of lists. Each bit within 
this grid symbolizes a 102 word mass storage area. The file increment 
of any 102 word module within the basic job library can be determined by 
the position of its representive bit in the map. The file incr^ent is 
equal to the horizontal position, which forms the upper two digits of the 
bit map increment, plus the vertical position, which represents the last 
two digits of the bit map increment^ times -Ui© module size (102) • 



35 ... 



3 2 10 




Word 01. plus bit position 
equals 0201 . * 

0201 is defined as a link. 



The list in the example above would represent a 102 word module at file 
increment 0201 x 102 = 20501. 

As the storage is used the bits representing the area used are set in 
the bit map. To find a hole for storage the bit map is checked verti- 
cally from right to left. 

A groiip library is not placed in the basic job library, but an eztension 
to the job library is requested to hold the group library. If there is 
insufficient storage in the basic job library for the storage of an element 
an extension will be created similar to that created for a group library. 

The bit map is read with lock to prevent the manipulation of the bit map 
by different routines at the same time. 

Upon termination all element storage associated with the job will be re- 
leased. 

The routines used to manipulate the bit map in library maintenance are 
EM, which is used to request storage and BMD which is used to release 
storage to the systom.. 
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GROUP MD SYSTEM LIBRART FORMAT WITHIN LIBRARY COMPLEX 



LIBRARI NUMBER 



INCREMENT TO TOO 



INC. TO EP TBL 



LENGTH TOTAL LIB 



LENGTH ABS TOG 



LENGTH RB TOC 



LENGTH OF SOURCE TOG 

I ' II II. • ■ ■ I II > 



LENGTH OF Edef . 



B 



A 



E 



£ 



H 



E 



N 



ENTRI POINTS FOR RB ELMENTS 



ABS TOGS 



RBS TOGS 



SOURCE TOCS 
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Entry Point Table for Group and System Library 



7 7 7 7 7 



TOG NUMBER 



N N N N N 
N N N N J^ 



CO 



VALUE 



ELEMENT EDEFS 

For the group or system library 
all EDEFS are collected from the 
individual relative binary elements. 
Each EDEF is logical placed in the 
table in a direct relationship to its 
associated TOG. The TOGS are stored 
in descending order. Therefore, the 
last entry in the EDEF table has a 
TOG NUMBER equal to zero. Upon use, 
the collector loader is enabled "to 
correlate EDEF and TOO with a degree 
of efficiency. 



■^ 
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.Representation Of A TOG Module And Individual Internal TOG 



4 
1 

2 
3 
4 
5 
6 
7 
10 

1 
2 
3 

5 
6 

7 

TO 

1 
2 
3 

5 

6 

7 

10 



# ENTRIES 


ef OR LINK NEXT MOD. 


. 


(SOURCE £LT.)3- 


ERROR IND. 


N N , 
N N 
V Y 


N N . . • N 
N N ■ N 
V V V . 


INCREMENT TO ELT. 


BASE 


UNASSIGNED 


UNASSIGNED 


(SUB. CODE) B 


§ IMAGES IN ELT. 


TOTAL ELEMENT LENGTH 


(ABSOLUTE ELT.) 2 


ERROR IND. 


N N . 
N N 
V V 


N N N 
N N N 
Y V V 


INCREMENT TO ELT. 


BASE 


MAX. CORE USED 


LENGTH OF CONTROL 


• § SEGMENTS 


# ASG IMJIGES 




# SDEF 




INDEX TO SDEF 


(REL. BINARY) 1 


ERROR IND. 


N N 

. N ■ N 

V V 


1 

I 


% N N 
Nf N N ." 
1 V V 


INCREMENT TO ELT. 


BASE 


INDEX TO XREF 


INDEX TO CC 


INDEX TO INFO 


INDEX TO SDEF 




INDEX TO TEXT 


LENGTH OF TEXT 
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RB ELMEKT 


Word 


Word 1-3 


Word 4 


Word 5 



DiiSCRi-PTlON OF TOG CONTEm'S 



A number indicating an RB element. The lower of 
this word is used for error indication, 

A 10 character name and a 5' character version. All 
unused portions of th^se 3 words are space (05) filled. 

An increment from the base of the Job library at ' 
which the . element can be f oiind . 

U = an index from the increment in word U which relates 
the start of the XREFS and also' relates the length of * 
the EDEFS . 

L = index to start of the ■ cc and relates the length 
of the XREFS 

Word 6 U = index to start of the INFO and the length of the cc 

L = index to start of the SDEF and the length of the INFO 

L = index to start of the text and the length of the SDEF 

Length of the text 



U = Absolute type number (2) 

L = Error indicator - • 

Same as in RB element 

Same as in RB element 

U = the maximum amount of core utilized at any one time 
L = spare 

L = number of ASG images 

L = the number of SDEFS 

Index to SDEFS 



U = source type number (3) . 
L = Error indicator 

Same as in RB element 

Same as in RB element 
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Word 7 


. Word 10 : 


2. ABSOLUTE ELEMENT 


Word 1 


• Word 1-3 ! 


Word U 


Word 5 ' 


Word 6 


Word 7 


Word 10 


3. SOURCE ELEMENT 


Word jZl 


Word 1-3. 


Word U J 



Word 5' Unas signed 

Word 6 Unas signed 

Word 7 U = subtype (b) indicating an internally compressed 
source while subtype (A) indicates normal source 
from primary input stream. 
L = the number of images of compressed source type (b) 

The total length of type (3)4 compressed source^ or *' 
•the total number of type (A)T^non-compressed source^ 
in field data code. 
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Source Element 



INDEX TO NEXT SOURCE IMAGE 



IxNDEX TO NEXT SOURCE IMAGE 



A source image is received from the. 
primary input stream with trailing . 
spaces removed. Hence, the term 
.(compressed source) is defined. As 
each source image is encountered, an 
index to the next image is attached* 
The index and the compressed image.: 
is buffered onto the job library, . 
With each successive compression 
occurring the Job Library saves 
prime etoragei * 
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Library Tape Format 






7 2 7 2 7 2 


7 


2 7 2 


1 


7 2 7 2 7 2 


7 


2 7 2 


2 


.FILE 


3 


• 


U 


IDENTIFIER 


5 


DATE 


6 


• 


7 


TIMS 


10 




11 


# ELEMENTS 


12 


# RB ELEMENTS 


13 


# ABS ELT 


U 


# SOURCE ELT 


15 


DRUM REQUIREMENT 


FOR 


STORAGE 








7 2 7 2 7 2 


7 


2 7 2 


Oa 


7 2 7 2 7 2 


7 


2 7 2 



File Header - This record will be the 
initial block on a library output tape. 
A rewrite of this block is performed by 
EI24 in order to insert the drum require- 
ments of the library and the number 
of elements within the library. The 
header size is 30g words. 
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9.3 



TEST SYSTEM 



SEG I 



/■ 



■ ALL 
CONTROL 
CARDS 



COM'ILE AND INITIALIZE 

THE OMEGA 

TEST SYSTEM 




INITIALIZE 

TEST 
ENVIRONMENT 



LOAD PROGRAM 
TO BE 
TESTED 






.AT 



LOOK UP ) 
\ SUB-RT/ 

^ L-. 

COMPUTE 
P- 
SUB-RT 



JL 



COMPILE 
IF 



sy 



COMPILE 
EXIT 



\- 




COMPILE 
DUMP 



STORE 
PACKET 
\TABLES 



J \ 



COMPILE 
TRACE 



SET UP 
SWITCH 
\TABLES / 



M^ 



A 



COMPILE 
TRAP. 



SET UP 
PARAMETER 
\TABLES / 



^ / 



1. 



COMPILE 
SET 



\ 



SET- UP 

JUMP 

TABLES. 



\ 



SET LT 
TRACE 
/ .\TABLES 
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TEST SYSTEM 



SSG II 



BASIC LOGIC TO PROCESS 

THE TEST STATEMENTS , 

[switch TABLES; PAEM TABLES ' 
]TE,ST PACKET STORAGE; JUMP TABLES 
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SEG III 



I^ERPRETIVE 
EXECUTOR 
(TSEARCH)- . (JUMP TABLES) 

(TRAP SRH) 



TRAP & 
EXECUTE 
INSTRUCTIONS 




MEMORY 
PROTECT 



^ 



±1. 



TSEARCH 
SUB-RT 



j*L 



PROCESS 

EXRN 

FUNCTIONS 




TRAP SEARCH 
SUB-RT 
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OPERATING TEST SYSTEM IN CORE 



iMx 11 



BASIC LOGIC TO PROCESS 
TEST STATEMENTS 



SWITCH TABLES: PARM TABLES 
TEST PACKETS STORAGE 



RIR = 00000 PLR - LOWER 



3EG III 



PROGRAM, 



UNDER TEST 



INTERPRETIVE 
EXECUTOR 



TSEARCH: DUMP; SET; AT; IF; EXIT; TRACED 



TRAPSRH; TRAP* 



RIR = 00000 



PLR - UP?E]i , 
*NOTE; Whenever a bit is made control is given to SEG. II for processing. 
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Phase I Test Package COMPILE 



The Compile phase of the test Package is called into memory by means 
of the .standard job card. The initialization phase consists of the 

following: 



(a 
(b 
(o 
(d 
(e 
(f 



Set all B Registers to zero 

Clear work areas • 

Get necessary core set RIR and PLR 

Locate SDEF tables of program to be placed under test, 

Load SDEF and Vector tables of the program under test, 

Set all control switches to off. 



Card Read Section 



The cards are read and processed by this section and all follow the 
same chain of logic: 

(a) The first 5 field data characters are used and a search 
is made of a table of all valid secondary control state- 
ments. If no hit is found the card is rejected and printed 
as an error card. Control is then returned to the card 
read segment and step (a) is repeated. Note error cards 
may not stop the test package. The test package will 
continue until it reaches an end condition. 

(b) Whenever a hit is found the card image is first submitted 
to the unstringer and then control is transferred to the 
proper subroutine to process that statement. - All 
statements are processed by their own separate subroutine* 
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Search Table for all Valid Secondary Control Statements 





-AT— 




--P-BEG 


2. 


-IF— 




— P-BEG 


3. 


-DUKP 


• 


— P-REG, 


u. 


-TRAC 


, 


E-P-REG 


5« 


-TRAP 




—P-REG 


6. 


-SET- 




— P-REG 


^7 


--EXIT 




—P-REG 


8. 


-END- . 




—P-REG 
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COMPILE-AT- 



Example: -AT— P/A,Vq/V^ ,B 

1 . Since the card is already unstrung P is computed by a return 
jump to the Compute P subroutine, 

2. Save Segment Number and P value 

3» Test to see if switch A is given. If yes. • Then set switch 
off and store location in packet. If no. Then set location 
for switch #27*. 

4.» Set counter in packet equal to zero. 

5. Convert Vq to Binary and store in packet. If Vq is equal to 
spaces set ¥^=1 and V.=7777 and skip to (7) 

6. Convert V-j to Binaiy and store in packet if spaces set 
to all seven,. 

7. Test for switch B, If given set up logic and store in 
packet. If it is not given then set for switch #27*. 

. 8, Increment B1 , B2 and exit. 



Packet 



SWITCHB 


SWITCHA 


VO 


V1 


Counter 


SEG # 



*^Note. Switch #27 is a dummy switch that is always turned oni 
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Compile IF 



Example: -IF — P/A, ( ) // ( ) * or * #^ext expression 

' ' and 



Relation 



operat.0 
connector [ 




continuation symbol 



1 • The P value is gotten by a Return Jump to the Compute 
P subroutine and along with the segment # is stored 
in the Packet. 

2. Test for switch one. If it is spaces set it equal to 
switch #27. If a switch is specified set up the proper 
logic and store the switch in the packet. 

3. Compute the relational expression in the following manner: 

a. Get the K value and save, if no K was specified then 
the value within the open and closed parenthesis 

is assumed to be an arithmetic constant and is converted 
to binary if necessary and stored at TIFPKTi^O / B4 for 
future reference. This address is then submitted for 
the A operand. Go to (d), 

b. If K was found then the value within the parenthesis 
is assumed to be an address and is computed by going 
to the compute P subroutine. 

c. The A operand address complete with designator is saved. 

d. The Test portion of the expression is saved for later 
reference. 

e. Steps (a) through (b) are repeated to get the next 
portion of the expression and it is treated as tli© 
B operand. 

f • The operator is tested for AM), OR. The routine 
brances on the AND or OR, 

g. Test for B-A condition. If present then switch 
operands (B for A) , 

h. Branch on the test (EQ, GE, etc.) 

i. Get K and Y operand for the ENTER A instruction. 
ENT*A^*A address. 

Get K and Y operand for subtract A instruction. 

Sub»A*B Address with proper J designator. 
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example: ENT^A^ operand 

SUB^A^^B operand ^.J 

JP^ continue 

Note: The Jump is set to accept if the operator 
was an OR, and to reject if the operator 
was an AND. The J is set to skip on a 
miss for an OR operator and to skip on a 
Hit for the MiD operator. The end results 
is that the same 3 instructions are used 
for all relational expressions . 

j « A 'check is made after each operator for a continuation 
card . This is the only place where a request for a 
continuation card can be made. Any number of continua- 
tion cards may be given. 

k» Repeat steps (a) through (i) as many times as there 
are relational expressions. 

1. When the comma is detected after an operator the 
IF statement is closed out. The switch is set up 
to be turned on or off depending on the acceptance 
or rejection of the IF statement. 

Sample IF statement: 

-IF— START /A,L (SUMX/$) /EQ/ L(YSUM) *0R^^# ' 
W(XLIST) /LT/ (666) ^OR^^L (DOG) /GT/ (60) ^AND*,B 

The total racked compiled for this would be; 



The table is to be 
tested 

jWhen P=START 
of the operating program 



TABLE 



SEG# TSWITGH = A OC 

TSWITCH = B 01 

ENT^A^L (SUMX / 5) 

SUB^A^L. (YSUM) *ANOT 

JP^TABLE / 011 

ENT^AitW (XLIST) 

SUB^Ai^W (TIFPKT40 / B4)*AP0S 

JP^^TABLE / 011 

JP^ TREJEGT , 

ENT4tA*W(TIFPKT40 / B^) 

SUB^A^L (DOG) ^*ANBG • 

JP^ TREJECT 

JPitTACCEPT 



OR Test 1 



OR Test 2 



AND Test 3 
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These instructions would be generated and stored in the test bed. 
Each tine the P value was reached in the program unqer test, am 
the switch A is on, then control would be given to TABLE / 2," 



AND 


1.. 


m 


•A=B 


; J 


= U ; 


AZERO 


; A-B 




2. 


GT- 


A>B. ; 


. J 


= 7 J 


ANEG J 


, B-A 




3. 


LT 


A<B 


I J 


= 7 i 


ANEG 


, A-B 




4. 


KS 


A^B 


; ^ 


= 5 ; 


ANOT , 


A-B 




5. 


GE 


A^B ; 


J 


= 6 ; 


APOS J 


A-B 




6. 


T.K 


A^ . 


; J 


= 6 J 


APOS J 


; B-A 


OE 


1. 


EQ 


A=B , 


» J 


= 5 ; 


ANOT 


; A-B 




2. 


GT 


A>B \ 


- 3 


= 6 ; 


APOS ; 


B-A 




3. 


LT 


A<B 


; J 


= 6 ; 


APOS J 


, A-B 




u. 


m 


A?^B ; 


J 


= U ; 


AZERO ^ 


A-B 




5. 


GE 


A^B J 


J 


= 7 ; 


ANEG' 3 


A-B 




6. 


LE 


AiB J 


J 


= 7 ; 


ANEG J 


B-A 



Restrictions: (a) There cannot be more than 20(g) consecutive 

OR operators in any one IF statement. 



(b) There carinot be more than 25 j'kV constants used 
in all the IF statements. 



\B) 
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Compile the DUMP statement. 
Example: -DUMP-OPTIONS-P/SWITGH, Vo,V^,V2 

1. P is computed by a retuj^n to the compute P subroutine 

. and along with the -Segment Number is stored in the^ DUKP 
Packet. « ' 

2. Set the options. If none are given set for octal. 

3. The s^idtchis tested. If spaces then the Dummy switch 
is set. If it is not spaces then the switch logic is; 
set up. 

4. Convert Vq and store, 

5. Convert V-j and store. 

6. Convert V2 and store, if it is present. If Vn is not 
present .then it will be treated as Zeros. 



DUMP PACKET 


Base Vq address < # of V^ words 


■ • ■ ■ 


OPTION ' File V2 Code 




SWITCH ■ I SEG # 
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Compile TRACE statement 



■ Example : -TRAGE-OPTIONS-SWITCH , START ,END 

1. Test for and set switch, 'If the switch is left blank 
then set the Dummy switch. . 

2. The. start location is gotten by doing a return jimp to 
the Compute P subroutine. Both the P setting and Segment 
Number are saved. 

3. The end location is gotten by a return jump to the Comput( 
? subroutine. Both the P setting and the Segment Number 
are saved . 

4., The Option is checked for a complete trace or a logical 
trace only. If a complete trace is requested then. zeros 
are stored in the packet. If it is to be a logical trace 
only, then 5 sevens are stored in the packet. 



TRACE Tab Packet 







SEG # 
START 
77777 



SEG # 

START 




# Tests 
SWITCH 
END 
SEG # 



SWITCH 

END 

SEG# 



Packet. 1 



> 'Packet n 
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Compile the SET Statement 

Example: -SET— P/SWITCH, Store Address, Value^/Value2,— ,# 

Store Address, __/_,__/__,___/_> 

1 • The P is gotten by a return '.jump to the Compute P 

subroutine. Store the Segment Number and the P setting, 

2. Test and set switch. If spaces, set Dummy switch. If a 
switch is given then set up the proper logic. 

3. The store address is gotten by doing a return jump to the' 
Compute P subroutine . The Segment Number is compared to 
see if it is in the same segment as the P of step"'(l). 

If it is a different Segment Number then an error print 
occurs and the routine exits, 

4., If valid the store address is saved in the Packet store area. 

5. The first half of the value is gotten by a return jump 
to the Compute P subroutine. 

6. Step ($) is repeated for the second half. The two halves 
are combined and the 30 bit word is stored in the packet 
storage. 

7. A check is made for a continuation card and if present 
the card is read and . control is returned to step (3) . 

, 8.. A check is made for a end of data symbol, if present the 
packet is stored and the routine exits . 

9. If neither (?) or (8) is true then Control is returned 
to atep (5). 



Set Packet j SWITCH. 

j P-Setting 



P-Setting 



SEG # 
# Words 



# Words 



77777 



77777 
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Compile the TRAP Statement 



Example: -TRAP-OPTIONS-P/SWITCH 

1." P is gotten by a return j-ump to the Compute P subroutine. 
The P setting and the Segment Number are stored in the 
test package. 

2. The switch is tested for and, if spaces then is set to 

the dummy switch, if given then the proper logic is set up< 

3i The Option is stored if given. If no Options are given 
the octal conversion is assumed. 



■TRAP Packet | SEG # " j OPTIONS 

1 

I SWITCH 
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Compile the EXIT Statement 



Example: -EXIT~P/SWITCH 



1. P is gotten by a return jump to the Compute P subroutine, 

2.' The switch is tested for, and if present then the proper 
logio is set, if it is omitted then the Duamy switch- is set. 



3. EXIT 

Packet 



SEG # 



SWITCH 
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Test Package SEG II Test and Perform 



'est-AT -Statement and Perform 

1 . ■ Control comes from the TSEARCH ROUTIKE and B7 holds the 
address of the Test Packet. 

2.' Test switch on: 

No: Exit 
Yes: Continue 

3 . Test if the Routine is in the correct segment 

No: Exit 
Yes: Continue 

U» Perform AT Statement 

a. Test V-j equal to 0. If Yes then EXIT 

b. Increment counter and test if equal to Vq. If Yes. 
Turn the switch on clear the counter and subtract 



one from V^ then exit. 
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Test-IF-Statement and Perfonn 



1 . Control comes from the TSEARCH Routine and B7 holds the 
address of the test packet. 

2. Test if the switch conditional to the performance of the 
IF Statement is on. If it is off exit . 

3. Test if this is the correct segment. If not then EXIT . 

4. Go Perform the IF Statements logical tests, if the decision 
is to accept then turn the indicated switch on and EXIT. 

• If the decision is to reject then turn the indicated switch 

off and. EXIT. . 
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Test-DUMP -Statement and Perform 

1-. Control comes from the TSEARCH Routine and B7 holds the 
address of the test packet. 

2, Test if the conditior^^ switch is on. If off then EXIT . 

3. Test if this is the correct segment. If it is not then EXIT . 
/* Submit packet to the DUMP ROUTINE,. 

5 . EXIT when control is returned . 

6. Perform- DUMP' • ; 

a. Clear' the initial print line 

b. Branch on the OPTION Code 

1 . A OCTAL 

2. B Field Data 

3. C Binary to decimal 

4. D Double precision Floating point to its 
decimal representation. 

7'» OGTALs Convert binary number to its field data equivalent 
and print the base address of the print line and 
8 words. 

8. Cycle on Step 7 until print packet is exhausted^ .then EXIT. 

9. FIELD DATA ■ ' ^. 
Move the data directly to the print line and print. 

10. BINARY TO DECIMAL 

- Convert the data to its decimal representation. , A maximiM 
of ten characters per 30 bit word. • 

1 1 . Floating Point Descale Routine 

Convert the 60 bit word, and shift it to the print line. 
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Test-TKACE-and Perform 



1 . Control comes from the TSEARCH Routine and B? holds the 
address of the Test Packet. 

2. Test for the correct' segment number range. If it is not 

then EXIT. 

3. Test if this location is within the proper limits. If it 
is then go to step 5. 

4. Continue search of TRACE TABLE by incrementing to the next 
test packet. If the last packet has been checked then 
EXIT. If it has not then go to step 2. 

$. Test to see if -this is a logical trace only. If it is 
then go to step 7. 

6. Go Perform the printing trace and then EXIT. 

7. Test if the instruction being interpretively executed is 
either a jump or a return jump. If it is go to step 5. 

If it is not then EXIT. 

Note;1: If this is a complete printing trace option and the instruction 
being interpretively executed is the Repeat instruction then 
the instruction being repeated vail be printed without the 
registers settings. 

Note 2: Those registers remaining the same as in. the previous 
print, either trace or trap, will not be printed again 
until their values change. 
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Test-TRAP-and Perform. 



1 .- ■ Control comes, from the TRAPSRH Routine and B7 holds the 
address of the test packet. 

2. . The logical switch is tested. If it is off the Routine 

exits , ■ ' 

3. The segment number is. tested. If this is the wrong segment 
then the routine exits. , ' 

U, Perform the. TRAP Operation 

■ a. Convert the address of the trapped location to its 
Octal representation. 

b. Branch on the option 

1) Octal: Convert the 30 Bit word to its octal 
. representation, and move it to the Trap buffer. 
Go to step 5) . ' 

2). Field Data: Transfer the field data word to the Trap 
buffer and go to $) . 

3) Decimal: Convert word to its decimal equivalent and 
•, move to the Trap buffer. Go to step 5). 

4-) ■ Floating Point: Convert the 60 Bit value to its 
•■ decimal equivalent and move to the Trap b'offer, ■ 

5) Print the Trap Buffer line 

6) RJP .to the printing trace and print the instruction . 
that is making the change, and the registers, the 
same as in the printing trace. 

7) EXIT 
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1 . Control comes from the TSEARCH Routine and B7 holds the 
. address of the test packet. 

.2. Test logical switch. If it is off EXIT. 

3. Test segment #. If it is not the correct one then EXIT. 

U, Perform Set: 

a. Pick up the P setting and number .of words,, if they 
are equal to all sevens then EXIT. 

b. Transfer the number of words, specified in the lower 
of the first word, to the store address specified 

by the upper of the first word. 

c- Iiicreiiiert "to "the iiaxt 'table and zo to star) a. ■ 
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xesXr-jiiAxx-ana reriorm 

1 . Control comes from the TSEARCH Routine and B7 holds the 
location of the test packet. 

2. Test the logical switch. If it is off then EXIT. 

3. Test the segment number. If it is incorrect then EXIT. 

4.. Set up the. ending logic and terminate the activity under 
test . 
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INTERPRETIVE EXECUTOR SEG III 
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Table Look Up Routine 



TSSARCH 



1 . The function of ^this routine is to search through the 
JUMPTA3LE for all Debugging Statements and then give 
control to the proper subroutine. 

2. Control coines from the interpretive executor by means of 
a return jump, ■•■ :. : 

3. The total num/oer of .tests is entered into-B7 and the search 
is' begun from the bottom of the JUMPTABLE; B7 is used 

■ ' to carry the position in the jump table. B7 is also used 
to locate the corresponding position of the Parameter 
table . 

4-. Vlhenever a HIT -is found B7 is stored in the upper of 

TSEARCH and Control is given to the proper Debug Statement 
subroutine . 

5. When Control is returned from the Debug Statement, B7' is 
entered with the upper of TSSARCH and the Search continues 
until the entire table has been searched. Then exit. 



9.3-24 



Table Look Up Routine 



TRAPSRH 



1 . The function of this routine is to search through the 
■ JUMPTABLE.-- The method is the same as in the TSEARCH 

routine. It differs only in that whenever a hit is 
detected., a further check is made to see^if this is a 
request for a Trap Operation. If it is not then 3? is 
decremented and the JUMPTA3LE Search is continued. 

2. Control comes to this routine from the interpretive 
executor and only whenever the program under test tries 
to store, to memory. 

3. The routine exits only whenever the complete JIMPTABLE 
has been searched. 



9.3-25 



9.6 RSXecutor 

The 4.94. ■REXecu tor is composed 'of a pair of secondary Exec routines 
developed to load and control the execution of batch type programs 
coded for use in a REX environment on the UNIVAG 490.' This routine 
provides "the user an ability to run one or more REX oriented programs 
concurrently with OI^ISGA oriented programs on the UNIVAC 494. 

9*6,1 Method of Operation 

Programs loaded' and controlled by the REXecutor are activated 
and described via- primary and secondary control' statements 
embedded within a Job deck or- contained on the drum in the form _ 
of a source element. As the program is loaded an execution area-' 
is allocated as part of the program to capture REX requests and 
contain parameters required to execute the program. 

Upon completion of load^an allocation process, the described 
program is activated and allowed to run in a normal manner 
\intil it executes a return jump to the REX entry table (Locations 
I4O-I4.6). At this point the REXecutor will capture the rec^uest, 
reformat to OMEGA conventions and execute. Upon completion of the 
request program control will be returned by REX conventions with 
REX status codes. The fol 



^^ lowing figure illustrates core layout 



«'hich makes this possible, 



Orir-^ 
uo ~> 

RIR • 
"^'"RIR ' 
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Instructions required to capture 
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REX Reauest Registers 



Table Area 



REX Oriented Object 
Code 
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4— Base of Program 



•^ Upper Lock 
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9.6,2 The RSX Control Statement 

The BEX Control Statement signals the start of a' task which, 
•selected as any other OMEGA recognized task, will activate the' 
load and execution of HEX oriented batch prograiii(s) . All peri- 
pherals ^nd mass storage assignment used by REXecuted program 
must have been previously assigned to the task via ASG$ control 
statements. 

HEX Statement 

ttPiSXa Options A Minimum/^ximum, Name/Version, Library 

.Options are: 

X - Abort. Do net execute remainder of Job stream if errors 

encountered during load or execution of described program(s). 

y - Continue RSXecutor Phase 2 even through errors were detected 
curing load and interpretation of control .cards. 

Absence of X or Y options implies terminate task and skip to next 
task within Job stresm if errors are detected during load or 
interpretative execution of REX service requests. 

Specifications are: 

Kinimijm/i-'Ia^d.m.^jn is the amount of core storage,, in units of 100g 
words, required to load complex and/or simple relative' pro gram(s) 
•to be REXecuted. Selection will automatically increase specified 
amount of 4-OOg words to compensate for execution area. Maximum 
core including execution area may not exceed 32K. 

. Name/Version (optional) contains name and version of a source 
element on random storage containiig secondary REXecutor language 
statements required to process the task. 

Library Field (optional) identifies the library in which the source 
element is contained on random access storage when name/version 
option is used. Any one of the following specifications are valid: 

SISTM specifies the named source element is contained in 
systems library. 

JOB specifies the named source element is contained in the 
Users Job library. 

C-Pj3l"?/l;ibrary •'?-imber specifies the named source element is 
■ contained in the named group library previously linked to 
the job. 

In absence of library specification Job Library is assumed bj 
the REXecutor. 
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Errata Cards 

Errata cards contain corrections to REXecuted programs and must 
follow PROG statement for which they pertain. The follow the 
identical format used by REX. 

Card Column • Content 

1 "A" identifies card as errata. 
2-3 Segment niomber (blank implies control segment). 
4''=5 Unused 
6-10 ■■ y -y. Address relative to execution area; 4.OO3 plus 

relative address within program, in which first 
" errata^word is to be stored. 
11-80 Seven 10 character fields used to contain errata 
values. Errata words will be loaded at con- 
secutive addresses starting with address given 
• in columns 6-10. A blank correction word will 
terminate the card. 

Parameter Cards ' 

Parameter cards contain data to be stored within program at address 
specified by Executive Information Region (E. I.R. ) of the loaded 
program. Parameter cards must follow PROG statement for which they 
pertain. Two types of parameter cards are recognized, numeric and 
alphanumeric. 

Numeric Parameters: 

Card Column Content 

1 "B" identifies card as containing numeric parameters. 
2-3 Number of 30-bit words to be filled from content of 
. ^ this card. Blank implies 7, the maximum. 

' 4.-1 Unused 

11-80 Data storage - Seven 10 octal character fields to 
be stored in octal form. Blank colianns will be 
entered as zeros. Words will be unstrung and 
stored left to right until specified number of 
words have been stored. 

Alphanumeric Parameters: 

Card Column Content 

1 "C" identifies card as containing alphan^jmeric 
parameters. 
2-3 Octal number specifying the number of computer 

words to be filled from this card. Blank implies 
16 octal, the maximum. 
■ 4-10 Unused 

11-80 Alphanumeric data words -I6, 5 character fields to be 
stored in "ohair fieldata form. Words v-dll be 
stored left to right until specified number of 
words have been stored. 
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Secondaiy Control Statements innnediately follow HEX control card 
or are contained on random storage; and, describe program(s) to 
be loaded, HEX parameters or errata, and map peripheral and mass 
storage assignments from Cl'ffiGA to HEX conventions. Secondary 
control statements are terminated by PS (Program Start) control 
statement. "' ■ ■ ^ '' 



The PROGram control statement is used to describe a simple or 
complex relative (SPUHT outputs 321 or 322 respectively) program 
which is to be loaded under control of the HEXecutor. Any number 
of PHOG cards can be submitted for any one execution to effect 
subroutine load. The only constrants placed upon complex or simple 
relative programs is that total amount core required by programs 
plus the PvSXecutor execution area does not exceed 32K and that only 
one of the programs is segmented. The PHDG control statement is 
as follows: 

A PROG A Options A File Code, Program ID/Name, Base, Logical Address 

Options are: 

. P Described program is the main code capable of being segmented 
and receiving PuSX parameters. Only one object code program 
may contain "?" option for any one REXectuion. 

• L Rewind load servo before search of the program. 

E Release load medium assignment after program load. 

Specifications are: 

File Code the alphabetic file code of logical unit on which described 
object code resides normal magnetic. If assignment is random access 
storage "logical address" is rec^uired to define starting point of 
code. 

Program IDA'ame identifies the simple or complex relative program 
to be located and modified to running form. • Program ID is the ten 
character searchword of the code e.g. 7-47-47 lib #. Program name 
is ten character name assigned to the program, this field is optional 
if program ID is unique. 

Base , optional, used to specify a specific relative address on which 
the described program is to be loaded. If blank HEXecutor will load 
program beginning at the first available cell following execution 
•area previously loaded programs. I'/hen specified, value must be 
greater than ^OOg. Normally used to load additional subroutines. 
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Log:ical Address required only when random access storage is assigned 
as the source mediuin of the object program. Logical address is 
relative to assigned "file code" and is the beginning address of 
the object code. 

The MEAKS Control Statement ■ 

All peripheral and random access storage assignments used by the 
program(s) placed under control of ' the PJSXecutor must have been 
previously defined via the ASG control cards (see 5-1 of Programmer's 
Keference Manual) and described to the ESXecutor via the MMDw state- 
ments. This -feature not only insures proper execution of the program 
but allows- a degree of flexibility in altering peripheral type. For 
example, a program written for MISERVO IIA tape units can be changed 
to tjKIS3RY0 VIC tape units without reprogramming or reassembly-- of 
object program. • ■ 

The only exception to the facility assignment procedure is in the 
use of card and high speed printer subsystems. The REXecutor will 
resubmit RSX card and print packets to OMEGA' s primary and/or 
secondary elements urJ.ess otherwise assigned. 

The KEAl^S control statement is as follows: 

AMSAJ^S A Options A File Code, Channel/Unit, peripheral type. Drum 
■ Address/Length 

Where options are: 

A - Described unit is to be used to satisfy internal REX facility 
request when submitted by the program running in the REXecutor 
mode. Channel/unit may contain any unique channel/unit 
number not previously used by object code. 

Specifications are: 

File Code is the alphabetic file code to which the assignment has 
been previously assigned via the ASG control statement. 

Channel Alnit is the numeric channel/unit as defined by the SPURT 
MEAI^IS and ASSIGN statements. In the case of hand coded packets 
the channel/unit contained in the packet must be used. Channel/ 
unit will be used at execution time of an l/O packet to map 
request back to OMEGA file code and not as a physical ch/unit. 
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_reri.pnera± iToe is wie lanemonxu sxshA. perxpzieraj. o^pe xur wiiJ-un tne 
original HEX l/O packet or internal facility request yas coded 
for. The following are the valid entries. 

Mnemonic Subsystem 

FH8S0 FH880 Drum 

' FAST -^ FASTRMD ^ ' 

. mZk UNISSRVO IIA ^ 

T-ri-o/^ T-rnT-r riTni-)TT/-\ -r-r-r .'^'' /'TTTn AtT O AtTT TO 

Uri3'-' Ui^lbHiliVU J.J.J.U/1 V W/ Viu/ ViXAU 

■ , m3k ., .' .-;,. UIJISERVO IIIA 
. . GRIN . " Card Reader 

■ CSOUT ■ Card P-onch 

' PRINT High' Speed Printer 
■ PTIN Paper Tape Reader 

PTOUT Paper Tape Punch 

PIH ' Submit request to primary input 
POUT Submit request to primary output 
SOUT. Submit request to secondary output 

Drum AddressAength is required only if assignment is for random 
access storage and existing program uses absolute drum addresses 
to reference file. For each distinct file assigned on the UNIVAC ^^94- 
and used by the program under execution the absolute base address and 
file length assi:imed by the 4-90 program must be specified. File 
length is conveyed as number of words or sectors contained in current 
file. These values are used to effect the transition from absolute 
drum reference to logical increment and to determine which of 
several files reference is intended. 

Lack of specification implies program will use zero as the file base 
and that only one random access file is assigned. 

Relocatable mass storage declared by. complex relative (322) must be 
assigned to File code Y and mapped by MEANS statement. RSXecutor 
will set up E.I.R. of RSXecuted program to contain expressed value 
in the noimal manner. 

Segment Storage 

The RSXecutor allocates random access storage for segments and 
errata for a complex relative program. File code ZG is used for 
this purpose. 
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The Program Start Statement 

The Program Start Statement is used to terminate load process 
,. .,and activate execution of program. 

■ , A PS A Options /IP, A, Q, B1/B2/33M/B5/B6/B7 

Where options are: 

D - perform octal diimp of execution area upon completion of 
; REXecuted program regardless of reason normal or abnormal, 

E -Perform octal dvnp of execution area upon completion only 
; if error occurs during execution. 

P - Perform octal dump of execution area prior to execution of 

program. 

Specifications are: 

P contains alternate program start address relative to base of 
program area. Lack of specification implies use start location 
contained in 2.1. R. of program. 

A, & B' s optional used to specify register setting at time of 
execution. 

9.6.4- "HSXecutor Elements 

The PJSXecutor itself is composed of three distinct elements: 
HSZecutor Phase 1, HSXecutor Phase 2, and Execution area. 

Phase 1 is a non-reentrant secondary Exec routine responsible for 
the following functions related to load and control of HEX oriented 
programs . 

Interpret 2 iiiistrung control cards used to describe progr£ii(s) 
to be processed. 

. Load SPURT produced simple relative (321 output) or complex 
relative (322 output) programs and establish execution area. 

Initialize and activated REXecuted program. 

Submit all Error messages to primary output stream 
. Process STOPRUN and TERMRU:; service requests. 

Process P^X Loader service requests other than segment load. 
. Load segment errata when present. 
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Phase 2 is a reentrant secondary Exec' routine used to process 
normal REX Input/Output requests and their associated controls, 

. Order standard R3X Input/Output service requests 

. Process RSX Input/Output service requests 

, Process CKSTAT -service request.^ 

. Process TAXSOVSH service request. , 

. Process Segment Loads , . ' 

. 'Return program control to RSXecuted program. 

Call Phase 1 for Error conditions and all non-processed 
Loader functions.' 









10-Li.o'wvxng: 

. REX object code being executed. 

• Kaps and tables showing peripheral assignments and segments 
description. 

. • Pseudo REX entry locations and a limited set of instructions 
used to call Phase 1 or 2 upon each REX service request. 

, Work area used to submit reformatted l/O requests to OMEGA. 

9.6.5 RSXecutor Phase 1 ' ' 

RSXecutor Phase 1 library number XXX is a non reentrant secondary 
Exec routine used to load, activate and execute REX service request 
which require exception processing for reasons of core buffers or 
elaborate interpretation. 

CALLS 

Phase 1 is activated via EXRN^2XXFC from Phase 2, or Execution area 
to perform some function v.dth regard to load .and control of REXecuted 
program. The follovring is a summary of function codes their caller 
and brief description of each followed by a functional description 
of each. 



Description 

Load and interpret control cards des- 
cribing RSXecuted program. 

Interpretively execute REX Loader 
service request. 
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Function 




Code 


Caller 


01 


Execution 


02 


Phase 2 



Function 




Code 


Caller 


03 


Execution 


04 ■■ 


Phase 2 


05 


Execution 


06 


Phase 2 


07 


Execution 


10. . 


Execution 


11 


Execution 


12 


Phase 2 


13-37 


TJn-as signed 



Descri"ption 
Process console TYPEC service requests 

Process STOPRUN, TSHMEUN or console 
functions. 

Invalid BEX. service request 

Submit diagnostic message 

Program Fault 

Memory Guard violation 

Illegal instruction execution 

Locate and load segment errata 



Function Code 01 is activated as the result of selection enco^ontering 
a HEX primary control statement in the Job control stream and select- 
ing it as the next task to be entered into the system. Upon activation 
selection has: assigned core area specified on REX control statement 
plus execution area, stored REX constrol statement in parameter storage 
with a "SSND$" operator, loaded initial execution area element and 
given program control to execution area. 

Initial instructions contained in execution area establish two queue 
process activity addendems: Activity 1 which is used to execute the 
program object code. Activity 2 which is used to execute input/out- 
put concurrently with instruction exectuion. Upon establishment of 
control threads a QRSF is executed to Activity 1 and "EETURN$" is 
executed. 

Purpose: Load and establish PwSX oriented batch programs for execution 
■ . within the OMEGA environment. This is accomplished by 

requiring and processing RSXexutors secondary control state- 
ments. 

Caller: Execution area as the result of QREF^ to Activity addendum 1 , 

Parameters: Task addendum contains core area assigned to the Task and 
link to RSX control statement which caused activation. REX 
control statement can be retrieved through use of the 
"RECEIVES" operator (See 9-6.2 for "RSX" control statement"). 
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Fionctions: a) Retrieve REX control statement, unstring and set 
up necessary linkages to retrieve REXecutor 
secondary control statements from random storage or 
primary input upon request from Step (b); 

b) Retrieve secondary control statement, submit to 
primary output for subsequent printing and jump to 
appropriate step dependent upon statement type. 
MEAUS statement go to Step (c), PROG statement go to 

•- Step Kdj, parameter or errata go to Step E, PS state= 
■ ••■ ment go to Step (f). If not one of the above submit 
■' the following diagnostic number 1 and repeat Step(b). 

c) Unstring and process MMNS statement setting on 
-appropriate entry in Table 1A and/or Table 1.' If 

table overflow or invalid parameter submit appro- 
priate diagnostic and repeat Step (b) . 

d) Unstring and process PROG statement by locating and 
modifying to running form complex or simple relative 
program described on PROG card. If "P" option given 
program is loaded and E.I.R. is set up describing core 
bounds and any random access storage assigned to File 
Code "Y" and mapped by previous MEAXS statement. If 
execution area overflow or errors detected submit 
appropriate diagnostic and repeat Step (b) . 

During Load process no modifications of ch/unit 
positions in REX l/O packets, T-tags or D-tags is 
performed. Therefore, original channel/unit numbers 
specified by "MEANS", FACIL, and ASSIGN SPURT 
directives will be contained in the packets at exec- 
ution time and must conform to channel/unit numbers 
used on MEANS secondary control statement. 

e) Unstring and store REX parameter or errata cards by 
REX conventions. If segment errata, store errata on 
mass storage follomng program segments and set 
appropriate segment .description bit in execution 
area indicating errata. Repeat Step (b) 

f ) Unstring Program Start card, store register settings 
and starting address if given in the allocated 
storage module for this activity. Close any remain- 
ing initialization of execution area and return pro- 
gram control. 

Exits: Normal return through "Content Supervisor" if REXecuted 
program (s) were successfully loaded or Y option on REX 
card given. 

S?:3D?. or ABORT return through "Content Supervisor" if errors 
detectad curing Load process. ABORT if X option on KSL card, 
SRPjOR e:vit if X or Y option on "KEX card are absent. 
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Function Code 02 is activated as the result of a call from Phase 2 
to process a service request normal directed -to the REX Loader. 

"Purpose: Interpretively execute HEX Loader service request. and 
return program control to requestor. 

I^arameters: ' B4. set to address of SMOD making Phase 1 request. 

^ B4. of :, requesting SMOD' set to address of SMOD containing 
RJSXecuted programs worker "B" registers. 
B$ of requesting SMOD set to address of execution area 
; of program. 

. 'B*6 'of requesting S-iOD set to address of EEXMOD allocated. 
" "P"- position of KEXl-lOD contains address of requesting EEX 
' packet relative to execution area. 

Function: . ' Retrieve BEl Loader packet and process as suimnarized 
by Table 9-1 .• . 

• Set Normal and Abnormal return address in RSXMOD to 
"P" plus packet length. Set B7 of REXMOD to if 
no errors were encountered during process of request. 
Set B7 non-zero if errors. 

Exit: Return control to Phase 2. 
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l^X Loader 



nction Code 



REX Service Request 




REXeciitor Action Taken 



00-10 
11 
12 
13 

15 
16 
17 
20 
21 
22 
23 
24, 
25 
26 



vD 

ON 

I 



Un-as signed 

Site Utility 

Un-as signed 

Real Time initialization 

Start Slave 

Re rim Duinp 

Print Drum 

Print core 

Subroutine load or R.T. extension 

Internal Load request 

Allocation request 

Segment Load 

Peripheral unit release 

Core release 

Random storage release 

Un-as signed 



REXecuted program is terminated. 

REXecuted program is terminated. 

REXecuted program is terminated. 

Skip and mark done. 

Skip and mark, done . 

Skip and mark done. 

Process & submit images to primary outpr 
»» »t . ; n II n n 

Skip and mark done. 

Skip and mark done. 

Locate previoufO.y reserved unti. 

Load segment ar. ' segment errata. ■ 

Release m.apped unit to OMEGA. 

Skip and mark, done. 

Release mapped storage to OMEGA. 

REXecuted program is terminated. 



Table 9-1 



. ACCEPT - submit following request to OMEGA 
' console handler, 

ENT^-B7^-Message Address 
EXRN^10l|Zf2 

Where message contains zero characters to print. 
Upon .return of' control store A and Q registers 
in ACCEPT specified buffer and exit to Phase 2. 
ACCEPT requests will be limited to 10 characters 
excluding stop code. 

. • STOP and TERMRUN - Submit appropriate termination 
message to primary output stream, set "done" 
indicator to execution area and exit to Phase 2. 

Exit: Return control to Phase 2 with normal and abnormal 
return. address of REXMOD set to end of packet. .B?'- 
of" REXJ-IOD should be clear to indicate successful 
completion. 

Eunction Code 05 - Activated when an invalid BEX service request 
is made. 

Caller: Execution area under Activity 1 of REXecuted program 
when it performs one of the following calls through 
REX pseudo interrupt registers. U and L of 136, 137, 
U3, U5. U of 1U, U6; L of U2. 

Parameters: B7 of calling SMOD contains "P" of request relative 
to execution area. 

Function: Submit following diagnostic to primary output stream; 

set ABORT indicator in execution area and abort control 
thread . 

ILLEGAL REX CALL 






thread option. 
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Function Uode 05 - Used by all routines to submit diagnostic 
messages. . , 

Caller: Phase 2, Execution area or an internal request from 
.; Phase 1 under either Activity 1 or 2 of REXecuted 
. . program. 

Parameters: B3 contains message number. 

runction: • . i.<.etrieve anu submit to primary uiagnostic message 
-• ••• indicated by B3. 

, Set indicators Done or Abort in execution area 
dependent upo^ message number (see Table 9-2). -- 

Exit: . Return control to requestor or abort control thread 
dependent upon message options. 



Function Code 07 - Used to process Program Fault (s) executed by 
PEXecuted program, - 

Caller: Execution area under Activity 1 . 

Parameters: Set to address of fault location. 

Function: . Return program control to fault recovery address 

specified in RHSecuted programs E.I.R. If fault 
recovery address not provided submit diagnostic 
and terminate task. 

Exit: . Return program control to fault recovery address 
if given. 

Terminate task if no recovery point given. 

Function Code 10 - Activated as the result of memory guard violation 

Caller: Execution area under Activity 1 . 

Function: Submit diagnostic message 27. 

Exit: Abort control thread through Content Supervisor. 

Function Code 11 - Activated as the result of executing a priviledged 

instruction (function code 776X-777X, except 7771 and 7775, and I/O 
instructions) . '- . 

Caller: Execution area under Activity 1. 






Function Code 11 r OnntlmipdV 

Function: Return program control to fault recovery address 
specified in REXecuted programs E.I.R. If fault 
recovery address not provided submit diagnostic 
message 30. 

Esdt: .' Return program control to fault recovery address 
if. specified. 

. Abort control thread if no recovery address given. 

Function Code 12 .- Load segment errata. 

Caller: Phase 2 as the result of a segment load. 

Parsmsters: 32 of stora-^s moculs co"^' tains sszzisnt niniLber Icacsc.. 
.Function: Locate and load segment errata for given segments 
Exit: Return control to Phase 2. 

9.6.6 Diagnostic Messages 

An element of Phase 1 within the RSXecutor is responsible for sub^ 
mission of all diagnostic messages conveyed to primary output 
'stream by the REXecutor. Upon activation of diagnostic routine B3 
contains binary number of message. to be submitted. B2 may contain 

. supplementary information; normally a binary, address to be strung 
into a five character numeric field and submitted along with the 
message. 

Message number is used to retrieve a one word Enter within a table 
which describes message and action to be taken upon completion of 
submission. Format is as follows (see Table 9-2 for messages): 

■ Bit Position Content 

29 Set to "1" implies additional data contained in 
B2 which is to be masked into last position of 
message before submission. 

28 Set to "1" request a check of "P" option from 

Program Start card if given dump Execution area. 

27 . Set to "1" request a check of "E" option from 

Program Start card if given dump Execution area. 

26 Set to "1" - Set "abort" indicator in Execution 
area u (word X) . 

2$ Set to "1" - Set "Done" indicator in Execution ■. 
area U (word X) . 
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Bit Position Content 

24 Set to "V - return control to requestor. 

23 Set to "1" - set SMOD to ABORT| exit if ".X" 
option given on "REX" card. 

22 Set to "1" - return control to requestor if "Y" 

' option given. ■ ' ^ ' 

.21 ,. Set to "V" « set SMQD to ERE0P4 exit. 

20-19 • Unused 

15--1B Length of diagnostic message. 

O-I4. Address of diagnostic message. 
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TABLE 9-2 



1 

.29 


2e>. 


,?:7 


1 


1 


1 
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1 
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1 







1 







1 




1 







1 







1 














1 


1 



„26 


„2i 


2k. 


21 


1 










































































1 

























































1 










1 










1 










1 










1 










1 










1 










1 













1 


1 


c 





1 


1 


c 


1 










1 










1 






















1 








1 



22 


21 


23 19 


18 15 


1A 


MESSAGE LITERAL . ^ . . 









6 


ERRj25 ' 


INVALID REXECUTOR CALL XXXXX 









7 


ERR1 


IREXEGUTOR CONTROL STATEMENT ERROR 









K 


ERR2 


MEANS TABLE OVERFLOVJ 









u • 


EKR3 


PROGRAM NOT FOUND . 









5 


ERRA 


CODE MODIFICATION FJIRDR 









5 


ERR5 


CORE STORA.GE OVERFLOW 









5 


ERR6 


PROGRAM CODE UNRJrADABLE 









6 


Eim7 


PROGRAM LOAD MEDIA UN-ASSIGNED - 









5 


ERino 


SEGMENT STORAGE OVERFLOW ■ ■'■ 









5 


.: ERR1 1 


INVALID ERRATA ADDRESS 









5 


ERR12 


INVALID PARAMETER STORAGE 









7 


ERR13 


INVALID PROGRAM START GIVEN XXXXX 









5 


Eimu 


ILLEGAL REX CAI.L XXXXX 









7 


ERR15 


INVALID REX LOADER REQUEST . XXXXX 








6 


ERR16 


NON DESCRIBED CHANNET, AND UNIT 








6 


ERR17 


NON DESCRIBED DRUM ADDRESS 








U 


ERR20 


FACILITY UN-ASSIGNED 








6 


EKR21 


UN-TRANSLATABLE REX PARAMETER 








7 


ERR22 


INVALID INPUT/OUTPUT FUNCTION CODE " 









3 


ERR23 . 


:rexmod overflow 










3 


ERR24. 


:rex termrun 










3 


ERR25 


:rex stoprun 









A 


ERR26 


PROGRAl-l FAULT XXXXX 









5 


ERR27 


PROGRAM LOCK VIOLATION 









7 


ERI130 


PRIVILEGFD INSTRUCTION VIOLATION 


1 







10 


ERR31 


:rexecutor control card un-recognizable 


1 


1 




6 


ERR32 


I/O error no error ADDRESS 



9.6.7 .HEXecntor Phase 2 - Library Nijunber XXX is a re-entrant Secondary 
Exec ro-'atine responsible for reformatting and executing standard 
■ REX I/O and associated controls: CKSTAT and TAKEOVER. Phase 2 
''•■■■■ Is activated by the following function codes. 



' . Description 

Reformat and execute l/O request 

Return program control to eligible 
lost control point 

REX input/output call 

REX CKSTAT call 

REX TAKEOVER call ' 

REX LOADER call . 

REX console request termrun or 
stoprun 



function 




: rJode 


Call 


01 


Internal 


02 


Internal 


03 ' 


u(uo) 


OA 


L'(UO) ■ 


05 


TJ(14.1) 


06 


L(1U) 


07 


U(142) 


10-37 


TJnassigned 
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Function Code 01 - Used to. translate and excute REX input/output 

request serial for any REXecuted program. 
See Table 9-3 for REX functions available. 



Caller: 

Parameters: 



Function: 



REXecutor, Phase 2, as the result' of a QREF to 
activity addendum 2 of REXecuted program. 

B4. - Set to address of storage module containing B 
register . settings at time of request. "A" register 
position of storage module contains address of 
assigned REXMOD. 

B$ - Set to address of. execution area of REXecuted 
program. 

Clear execution packet and retrieve REX. call packet. 
Locate equivalent OMEGA assignment from Table 9-1 or 
1A. through use of unit and/or channel number contained 
in REX packet. 

If peripheral type is FH880or FASTRAND translate 
drum address to logical increment and store in OMEGA 
packet. 

If peripheral type is 13 j 14 or 15 branch to routine 
to set up and execute appropriate request to 
Cooperative Control. 

With periphera-l type retrieve function code from 
REX packet. Retrieve "schedule number" from Table 9-4- 
by referencing word based on REX function code and 
location within word based on peripheral type. 

Access correct location of Table 9-5 based on 
"schedule number" obtained from Table 9-4- and perform 
the following: 

If 2 " set, retrieve buffer control word from 
REX packet and store as base address and number of 
words in OMEGA packet (base address is stored as 
relative to lower lock of the Phase 2 routine) . 

If 'kr set retrieve search word from REX packet 
and store in OMEGA nacket. 



Enter OMEGA function code in B1 and give control 
to the execution routine indicated by Table 9-5. 

The execution routines perform or simulate (Table 9-6) 
REX l/O requests "oj issuing I/O requests to OMEGA. 
Certain ?^X requests may require multiple OMEGA 
functions: (e.g. the execution routine responsible 
for BACXFILS would issue READ3$ functions until an 
end-of-f ile is encountered) . The following parameters 
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are requix'eu jy one execu 01011 rou'tiness 

B1 - OMEGA function code 
B4. - Storage module address 
B5 - Execution area address 
B6 - REX l/O packet address 

At the -completion of their operations the execution 
routines pass control to the Status routine . 

. The .Status routine converts the OMEGA status code 
■to Hex code and stores the appropriate code and 
indicators in the RSXMOD. The parameters required 
for operation are. as follows: 

B4. - Storage module address 
B5 - Execution area address 

A - OMEGA status code 

Q - Number of words transferred. 

The status routine performs the following functions: 

Stores the "number of words transferred" in A 
upper of the REXMOD. 

using peripheral type and OMEGA status determine 
REX status code. OMEGA status codes 0, 7 and 11 are ■ 
converted directly to REX status codes jZll , 10 and 
06 respectively.. OMEGA status code 10 will cause 
an abort condition (message number I6). The REX 
status codes corresponding to the remaining OMEGA 
codes vary with the peripheral type, and are 
obtained by referencing Table 9—7* A REX status 
code of 00 obtained from Table 9-7 will cause an 
abort condition. 

The REX status is placed in A-lower of the REXMOD. 
(Note: Abnormal frame counts on magnetic tape units 
will be indicated as in REX: A-lower equals 0^ , 
A-upper equals number of words transferred with 
2^" = 1 , and the magnitude of frame count error 
indicated in the lower six bits of the last buffer 
word) . 

B7 of the REXMOD is set to indicate normal or abnormal 
completion. "0" indicates nonnalj "1" indicates 
abnorm.al. If abnormal, the address of the REX l/O 
request is placed in Q-upper and the normal completion 
address in Q-lower of the REXMOD, 

Exit: . If REX function performed, control will be given "EXIT" 

routine (See Func-oion code 02) , 
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• If RSX function cannot be' performed program's 
"ABORT" indicator will be set and a direct switch 
to REXecutor Phase 1, Function code 06; with B3 

■ set- to one of the following diagnostic messages, 

B3 = 16 ■ KON DESCRIBED REX CHANNEL AND UNIT 

• . B3 = 17 ■ NON DESCRIBED -REX DRUM ADDRESS 

.B3'-='21 . UNTRANSLATABLE REX PARMETERS 

"■•■■■B3-=20 ■ FACILITI UNASSIGNED 

B3 = 22 INTALID INPUT/OUTPUT FUNCTION CODE 
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Function Code 02 - responsible for returning program control to 

REXecuted code upon completion of Input/Output, 
Loader, etc., service requests. ■' ' 

Caller: Phase 2 internally or Phase 1 by direct call under 
. " ' ■ either Activity 1 or 2. " 

Parameters:, Phase 2 set B5 to address of execution area. 

Function: A) Search for PwEXMOD with a 6 status code indicating 
some type of request without E.A.S. was given and 
• ■ ' is' domplete. If find made perform Step. C. 

; B)If TAKEOVER is not set exit. If TAKEOVER indicator 
, is set search for RSXMOD with 3 status code 
indicating 'some type of request with E.A.S. was 
given and is complete. If find made clear TAKEOVER 
indicator and perform Step C . . , 

C)Set up REXMCD for reVorn of control.' 

•If B7 of REXKOD = set B1 to normal return. 

•If B7 of RSXMOD. ^ Set B1 to abnormal return. 

• Set REXK.OD status to 77777. 

•Set B2 to REXMOD address relative to execution area, 

•Enter A and Q from P^XMOD 

•QRSF Activity 1 and Exit 

Exit: - Set P and B3 of calling SMOD to execute RETURN^ upon 
exit from Content Supervisor. 

If abnormal return indicated and error address of 
REXMOD = r, Set 33=32 and exit to Phase 1 , Function 
Code 06. 

Function Code 03 - Used to queue requests for normal l/O. 

Caller: 



Parameters: 
Function: 



Exit: 



Activity 1 PJSXecuted program when it performs a call 
to the U(U0). 

B7 set to address, relative to RIR, of request. 

•Set up RSXMOD, P,1-^ status 

•QPcSF Activity 2 for execution of Function code 01 
with B1 through B6 set to those of requestor. "A" 
set to address of RSXMOD. 

•Phase 1 of REXecutor if REXMOD overflow. 

•Return program control to end of REX l/O packet. 
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Function code OU - Used to process a CKSTAT request- 



Caller : 



Pai'aineters: 



Function: 



Exit: 



Activity 1 of REXecuted program when it performs 
a call to L(UO). 

37 set to the address, relative to RIR, of the 
CKSTAT request. • . ■ 

•Search for.RSXMOD which contains, addressed I/O request. 
If find is made set "Normal and Error" addresses 
and store' worker. B-registers in REXMOD. If find is 
not made locate 'available REXMOD, set "Normal and 
Error" addresses, store B-registers, set B7 and A. of 
REXMOD to 1 and respectively, and set status to 2. ^.. 

.If EAS = increment status by A. If EAS = 1 (TAKEOVER) 
increment status by1 and set TAKEOVER indicator. IF 
EAS 7^ or 1 , increment . status by 1 . ■ 

•Phase 1 if REXMOD overflow occurred. 

• Return control to REXecuted program when EASp^j^ or 1, 

• Go to "EXIT" routine when EAS = jZl or 1.. 



Function code 05 - Responsible for processing REX TAKEOVER. 

Caller: Execution area upon SILRJP^-U(14-1) under activity 
addendum 1 . 

Parameters: Phase 2' set 35 to address of execution area. 

Function: Set TAKEOVER indicator in execution area. 

Exit: Give program control to exit routine, See Function 

code 02. 



Function code 06 - Responsible for initial set up for processing of 

REX and/or ?^X loader service requests. (See table 
9-1 for detailed description of each) 

Caller: Execution area upon SILRJP^-L(144) under activity 
addendum 1 .' 

Parameters: 34 set to address of SMOD containing 31-36, A and 
Q at time of request. B? of SMOD contains packet 
address relative to execution area. Phase 2 sets 
35 to address of execution area. 

Function: A) Retrieve REXMOD, set status = 2, store worker 

31-36, and "?" of packet. If request for segment 
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Exit: 



B)For non-segment loads call Phase 1 Function code 02 
for processing. Upon return of control check E.A.S. 

• position. If zero E.A..S., update status by 4 and go 
to exit routine (See Function code 02, Phase 2) . If 
E.A.S. =1, set TAKEOVER- indicator, update status- 

• position. by 1, and go to exit routine. If E.A.S. 
specifies an address, update status by 1 and return 
control to specified -E.A.S. 

C) Load" indicated segnient and if segment' errata' indicated, 
"call- Phase 1 Function code 12 for errata placement in 
segment. Upon completion of load process update 
REXMOD status code by 4, update normal and abnormal 
return addresses and give program control to exit 
routine. 

•If request contained E.A.S., address update REXMOD 
for return of control, set SMOD P address to E.A.S. 
and return control through Content Supervisor. 

•If no E.A.S. or an E.A.S. of 1, update REXMOD for 
return of program and go to "exit" routine. 



Caller: 



responsible for initiating console requests or 
terminating the REXecuted task. 

Execution area upon SILRJP"U(14.2) under activity 
addend'om 1 . - 



Parameters: B4 set to address of SMOD containing B1-B6, A and Q 
registers at time of request ,. B7 of SMOD contains 
packet address relative to execution area. Phase 2 
sets B5 to address of execution area. 



Function: 



Retrieve REX service requests function code and 
process according to type. CONSOLE HOLD or Pi^LSASS 
update "P" of SMOD and return control to orogram 
(ignored). If REX STOPRUN, TSR^IRUN or TYPET, call 
Phase 1 function Oi for processing. If ACCEPT 
request, call Phase 1 function OU and process E.A.S. 
as described in Step A and B of Function code o6, 
Phase 2. 



Exit: 



'CONSOLE HOLD, RELEASE, TYPET or ACCEPT t^lth E.A.S. 
address specified, return program control to 
REXecuted program. 

•TERMRUN or STOPRUN abort activity 'through Content 
Supervisor. 

.ACCEPT without E.A.S. or with E.A.S. = 1, update 
PwSXMOD for return of control and go to exit routine, 
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I 



Ul'liJUXi 












uara 


jtiDr 




Function 


FHB80 Druin 


FASTRAND 


miSERvo im; 


UNISERVOIOD UNISERVOmA 


Subsystem 


Subsystem 


Paper Tape 


READ 


READ 


READ 


RlilADF 


liFADi 


READF 


READ-^ 


_ 


READF 


WKf.TE 


WRITE 


WRITE 


wraTE 


WRITE 


WRITE 


PUNCHY 


PRINT* 


PUNCH 


REIJVHJ) 


- 


" 


mmiw . 


RF.WIND 


RF,WIND ■ 


^ 


„ 


m.. 


RI^IJTKDI 


- 


— 


RWI 


RWI 


RWI 


»- 


•> 


— 


READB 


- 


— 


RFADB 


_ 


READB 


_. 


_ 


READB 


RKAJj(Notel) 


_ 


~ 


MOVEF 


MOVJIF 


MOVEF 


_ 


_ 


«•■ 


REA.D(Hote2) 


- 


— 


MOVED 


mwB 


MOVEB 


m. 


_ ', 


_. 


SEliYlOll 


SKA,RCH 


WSEARCH 


SEARCHF 


SEARCH 


SEARCHF 


— 


. 


„ 


R}!:M)r-(Noto3) 


- 


— 


SEARCHB 


^ 


SEAIiCHB 


. ^ 


^ 


„ 


SEARCfl 


LOCATE 


— 


LOCATI'lF 


^ 


LOCATFF 


_ 


„ 


_. 


Rl!'AI)}3(Notc2) 


- 


— 


LOCATEB 


— 


LOCATEB 


— 


„ 


_, 


WHITE 


~ 


m. 


PWitim; 


» 


_ 


PMGHS^ ' 


^ 


_ 


REATl(KTote3) 


— 


^ 


- 


BACKFILE 


— 


— ..■':• 


^ 


_ 


IGNORED (Note/J 


-. 


~- 


■ — 


LOBIN 


— 


RMODE^^M 


pin: 


', _ 


IGNOI]E.D(NoteA) 


- 


J. 


». 


HIBIN 


_ 


PMODF/'^-M 


_ 


_ 


IGNOin^;D(NotG/J 


— 


— 


_ 


LOBCD 


i_ 


_ 


^ 


"■ 


IGN01lJ';D(NotGA) 


- 


- ■ 


- 


HIBCD 


— 


— 


— 




VRITjilOF 


- 


- 


~ 


ENDFILE 


FJ^DFILE 


^ 


>. 


_ 


ERASE 


— 


— 


— 


'— 


WRITEO 


^ 


_ 


_ 


SEARCilP 


~ 


SEARCH 


_ 


_. 


_ 


„ 


_ 


^ 


Ignored 


- 


POSITION 


~ 


_ 


^ 


STACK1,1 


. 


^ 


BLOCKR 


BREAD 


» 


^ 


_ 


_ 


«. 


_ 


_ 


BLOCKS 


BSEARCH 


_ 


.. 


_ 


_ 


_ 


_ 


«a 


BLOCKS 


ELOCATE 


- 


— 


— 


i- 


. 


_' -. 


«. 


Ignored 


- 


- 


~ 


- 


- 


READNT' 


^ 


» 


Ignored 


- 


- 


- 


_- 


— 


TRANS 


i_ 


^ 


MIffiAD 












MREAD^ 




• 



Note 1 Repetitive Read N blocks 
Note 2 Repetitive Read back N blocks 
Note 3 Repetitive "Read back to E.O.F. 
Note 4 Effected via ASG control card 



Will be submitted to cooperative system MEAJ^S card had PI, PO or BO given for logical unit. 



TABLE 9-/^. is used to translate REX function code to simulated OMEGA routine and 
schedule (Table 3). 

TABLE 9-4. in REX Mnemonics 



00 

or 

02 
03 
04 
05 
06 
07 
10 

11 

12 
13 
U 
15 



FC 2^^-2^^ 

FH-S80 



-FC 2^^-22^ 

FASTRAHD 



FC 2^*^-22^ 



L^ISSRVO 



1IA,IIIA 



FC 2^*^-2^'' 

UNISERVO IIIC 



FC 2^^-2^^ 

CARD 



TTRTH^, 


UpTTE 


RWTND 


LOBIN 


STACK1 ■ 


READ - t 


READ 


[ RSI,-riNDI " 


HIBIN 


STACK2 


BRK4D 


SKiRCH 


SEARGHB 


LOBCD 


RMDNT . 


LOCATE 1 


wSKAiiCH 


SSARGHF ■ 


HIBCD 


R^ODE^-FD 


BLOGATE 


- POSITION 


P\\miTE 


SEARCH ■ 


WiODE^GBIN 


SEARCH 


- 


¥RITE0 


WRITE 


RMODE^-RBIN ■ 


BSEARCH 


- 


I^JRITE 


READ 


RK4D' 


— 


- 


ENDEILE 


ENDFILE • 


TRANS 


^ 




RSADF 


RS^/JIND 


MREAD 


_ 


- 


■ 


RS^/JINDI 


PUNCH 


— 


— 


P^A.DB 


BACKEILE 


PUN CHS 


- 


- ■ 


MOVSF 


M0VS3 


PMODE^-FD 


— 


_ 


KOVEB 


MO^VEi?' 


PMODE^CBIN 




- 


- 


-. 


PMODE^RBIN 



OQ ! j^3 i ^3 i 04- i 01 i 01 I 
0^ i ^2 ! ^2 j |)5 t 01 i ^1 f 
02 i ^''i i 17 i~2 ^ ^! P1 ) 21 I I 




03 


1^ 


\ 2L 


1 '^' i01 


1 jsi i t 


04 


12 

IP 


\ 01 

1 m 


i 03 1 

1 06 i 


1P- 


! m ! 


05 


03 


1 m ! 


06 


12 


\ 00 


1 03 t 


p2 


1 02 1 


07 


m 


i 00 


1 ^7 } 


07 


t 22 1 


10 




\ PP 


i p^ 1 


04 


1 23 i 


11 


m 


\ m 


; 00 ! 


^5 


! 03 ! 


12 





1 0P 


1 13 i 


16 


i 03 1 


13 


j20 


00 


) u 


15 


1 m t 


14. 


PP^ 


00 


i 15 


1/. • 


1 01 ! 


15 


W 


1 00 


i m 


00 


1 01 I 




2^9 


^24 


2^9 


2I4 


2^ 2^ 



TABLE 9-4 Actual-Each position contains an 
increment to the equivqlent OMEGA routine 
described by an entry in Table 9-5. 



9.6.7-9 



SCHEDULE 
HANDLER /^ 




15 







OMEGA 



o^/ c^ s?7 FJNCTION CODE 



ADDRESS OF 



/ 



T?VT?OTTfriT n\i 



llXiVHj 



/ 



OMEGA 
FUNCTION 



02 
03 
0lv 
^5 
06 
■01 

10 
11 
12 
13 

15 
16 
17 

2i^ 
21 
22 
23 
24 



z 



A 



T 



T 



1 



i 



1 1 



H 



T 



3: 











1 



2 



2 1 



-2 -2 



2 3 



0.20 



1. 6 



7 



1 1 



1 



1 1 



{0011 



1 I 



Ij2 01^1 



I ) 



-£ 



^i 1 



1 " 



10 6 



* # of blocks 
to move 



lOERR 



101 



102 



:02 



103 



103: 



103 



. 104 



102 



102 



102 



105 



105 



T11 



107 



108 



:09 



110 



112 



Error 
NO-OP 

READ$ 
WRITER 
.RElCENDl 
REWINDII 
ERASER 
WPJTEOFi 
SEARCH^ 
BLOCKR$ 
BLOGKS$ 
READB$' 
READ$ 
READB$ 

readbI 
ssarcht$,searchp$ 

READB$ 

Special READNT 
Special TRANS 
Special MREAD ■ 
SEARCH$ 



TABLE 9-5 Schedule List 
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/^ / 

/from / I 



Label of 
/Simulator 
Routine 



/ OMEGA 
I function 
used to 

simulate 



TABLE 9-6 



/ 



Description of Simulated Function 



00 

01 

02 

03 

0^ 

05 

06 

07 

10 

11 

12 

13 

U 

15 

16 

17 

21 
22 
23 



ERR1 

101 

102 

102 

103 

103 

103 

103 

104 

102 . 

102 

102 

10$. 

105 

106 



107 
108 
109 

no 

112 



READ$ 

WHITER 

REWIND^ 

REWINDI$ 

ERASER ■■ 

WRITEOFF' 

SEARGK$ 

BLOGKRi 

BLQGKS$ 

READB$ 

READ$' 

READB$ 

READB$ 

SEARCHP$ , 

searghpI 

READB$ 

(READ$) 

READ$ 

SEARCH^ 



Error MSG for invalid function REX function code 

No-operation - No simulation required. 

Normal READ operation 

Normal WRITE operation 

Normal Revind operation 

Normal Rewind with interlock operation 

Normal overwrite operation 

Normal write EOF mark 

Normal Search using, allocated buffer and BGW 

Normal FH-880 Block Read operation with logical address 

Normal FH-880 Block locate operation with logical addres 

Normal tape Read back 

Simulate MOVE forward N blocks 

Simulate MOVE back N blocks ■ ' ' 

Simulate BAGKFILE operation 

Simulate short and long first word search 

SimxUlate SSARCH3 operation 
Simulate. RSADNT operation 
Sim.ulate TRANS operation 
Simulate MREAD operation 
Simulate SEARCH 



9.6.7-11 



ON 
I 

K3 



\,^ OMEGA 
\s^TATUS 

P-TYPE ^\ 


Successful 
Completion 


Inapprop. 
Function 


Incorrect 

Parameter 


■ 
Unrecoverable 

Error 


End -of - 
File 


End -of - 
Tape 


Unsuccess. 
Search 


Illegal 
Char. 


No : 

Assign 


Inter- 
lock 




Successful 


Incorrect 
Parameter 


Incorrect 
Parameter 


Read 
Error 


Illegal 
Address 


■ 


EOB W/0 

Find 




-Abort 


Interlock 


DRUM 










Successful 


Incorrect 
Parameter 

Incorrect 
Parameter 


Incorrect 
Parameter 

Incorrect 
Parameter 


Subsystem 
Error 


Incorn 

Para- 
meter 




Unsuccess. 
Search • 




Abort 


Interlock 


FASTRAND 










Successful 


R/W 
Error 

Subsystem 
Error 


End-of- 
File 


End-of- 
Tape 






Abort 


1 

Interlock 


UNISERVO IIA 








UNISERVO IIIC 


Successful 


Incorrect 
Parameter 


Incorrect 

Parameter 


End-of- 
File 


End -of - 
Tape 






Abort 


Interlock 


IVG/VICAIIIC 








- 


Successful 


Incorrect 
Parameter 


Incorrect 
Parameter 


Subsystem 

Error 


End-of- 
File 


End-of- 
Tape 






Abort 


Interlock 


UNISERVO IIIA 










Successful 


Inapprop. 
Function 


Incorrect 
Parameter 


Illegal 
Function 








Illegal 
Char. 


Abort 


Interlock 


CARD 












Successful 


Illegal 
Function 


Illegal 
Par8,meter 


Illegal 
Error 










Abort 


Interlock 


PRINTER 












PAPER 


Successful 


Incorrect 


Incorrect 


Subsystem 
Error 










Abort 


Interlock 


TAPE 


Parameter 


Parameter 











TABLE 9-7 
REX STATUS CODES 



TABLE 9-7 ACTUAL 



"\^OMEGA 
, ^^->mTl3 
P-TYPE^\v 


S } 

1 


2 


3 


4 


^ 


6 " 


1 1 16 


16 


12 - 


■11 


00 


03 


2 


10 


10 


07 


10 


00 


02 ■ 


3 


"12 


12' 


'10 


04 


0^ 


00 


A 


10 


10 


07 


OL 


05 


00 


5 


10 


10 ■ 


07 


04. 


0^ 


00 


6 


12 


13 


11 


00 


00 


00 


7 


12 


1? 


11 


00 


00 


00 


10 10 


10 


07 


00 


00 


00 


11 10 


10 


07 


00 


00 


00 


12 


1 o 


10 


07 


AP, 
KJ\J 


00 


00 


' 


229 


224 


2I9 


2U 


2^ 


2^ 



NOTE: OMEGA status codes 
jZf, 7, 10 and T1 are 
converted directly. 

A REX code of 00 
from the Table will 
cause the program to 
be aborted. 



9.6.7-13 



9.6.8 Execution Area 

The Execution area is allocated vdth each program to be 

placed under control of the EEXecutor. This area is used 

to contain tables, interrupt instructions, and working storage 

required to control the. REXecuted program. The following map 

shows general layout of execution area. In general all addresses 

contained are relative to word of execution area. 

Word 



112 
160 

2U0 



375 



2^00 



Initialization and working storage 



1 Initi 



Unused 



Interrupt & return of control instructions 



Fixed area used to contain Indicators. 
Table pointer and REX pseudo interrupt ^ 

registers. 



< Segment Descriptors of REXecuted program ^ 
*^ limited to 2U^q S 



TA3LS1 used to map REX peripheral 
> assignments to OMEGA (30rt maximum) 



„ , TABLEIA used to map REX Drum addresses 
\ to logical increments (lO^ maximum) 



320 J REXMOD used to contain. CKSTAT values for 

^ return of control (5 maximum) ^ 



Area used to contain REX 321 and/or 322 
object code 



9.6.8-1 



V/ords - 

Initialization and Working Storage - This area is initially 
used to activate the REXecutor and contains instructions to 
perform the following: 

Register queue process Activity 1 used used to process 
instructions of the REXecuted program. 

, Register queue process Activity 2 used to reformat and 
execute Input/Output calls and REX Loader functions. 

. Establish contingence points for Fault, memory guard 
violation and priviledged instructions. 

Once REXecuted program is activated area will be used for 
working storage to interpretively execute Input/Output calls. 



Words 111 

Contains instructions required to accept calls to REX pseudo 
interrupt registers (SILRJ?^U^ (137-157) and calls REXecuter 
for processing. In general upon REX call P value is saved and 
a call to Phase 1 or Phase 2 of REXecutor is made via EXRN for 
"DrocesslnP'. 

These instructions may be extended to process additional calls 
peculiar to installation; such as calls to User File Control 
packages, etc. 



9.6.8-2 



Words 114-157 



Fixed portions of Execution area used to control and return 
program control during execution of REXecuted program. In 
general, this area may not be modified with change to REXecutor. 

Format: 



112 
113 
1U 
115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 

131 
132 
133 
134 
135 
136 
137 

uo 

141 
142 
143 
144 
U5 
146 
147 
150 



157 



BEGINNING LOGICAL ADDRESS 0? SEGMENT ERRATA 



ENDING LOGICAL ADDRESS' OF SEGMENT ERRATA 



E.I.R. ADDRESS 



PROGRAM BASE 



ZG 



SEGMMT LENGTH 



SEGMENT BASE 



LOGICAL A OF SEC->ESJT 



EXRN- 



PHASE 1 FC 07 



EXRN 



PHASE 1 FC 10 



EXRN 



PHASE 1 FC 11 



-# OF DESCRIPTORS 



ASEG. DESCRIPTORS 



# OF Ei\' TRIES 



A TABLE 1 



# OF ENTRIES 



A TABLE 1A 



# OF REIHOD 



^REXMOD 



EXRN---B3 







B7 ON TYPSC GAIL 



OPTIONS FROM REX & PPDG CARD 



iMREAD COUI\'T 



inms COUNT 



UNUSED 



USED FOR 

SEGMENT LOAD 
-^ FAULT 
-^ PLR VIOLATION 
-4 PRIVILEGED INSTRU . 

POINTERS TO'"" TABLES 



TAKEOVER INDICATOR; 



ABORT INDICATOR 



DONE INDICATOR 



DATE 



ERROR 



ERROR 



ERROR 



ERROR 



STANDARD l/O 



CKSTAT 



TAKEOVE.R 



TYPEC 



CONSOLE & EXIT 



CRROR 



ERROR 



ERROR 



ERJIOR 



REX LOAJDER 



EPJ^jOR 



ERK)R 



ADDRESS OF DATE 



TIMS OF DAY 



1 ON DISTRIBUTED VERSION THEY 
< ALL POINT TO ERROR PROCESSING 



PSEUDO REX REGISTERS 



PSEUDO INTERRUPT 
REGISTERS RESERVED 
BY SOMiS USERS 



Description of entries in fixed area. 



Word 
112-113 



Jescrintion 



Beginning and ending random storage logical increments 
containing segment errata. Each errata Enter on random 
storage is composed of two words as formed and stored 
by during initialization of Phase 1 . 



! ADDRESS OF WORD 



~'"=>::; T'i 



;VU 



RD 



9.6.8-3 



Word 



Description 



114 Upper contains address of 321 or 322 program contain- 
ing P option when loaded for REXec-ation (main program) . 
Lover contains Base Address for REX program area. 

115-117 Contains a random access packet used to load program 
segments of a 322 program. 

120-122 Contains calls to Phase 2 upon occurrence of contingency 
violations. Fault, Memory Quard and privileged in--- 
structions. 

123-126 ■ Contains increments and number of entries in each of 
the tables or lists. These can be varied to reflect 
installation requirements . 

127 A general EXEN used to call for OMEGA function from 

Execution area, ABORT, ERROR, RETURN, etc., which cannot 
be performed within the secondary Exec. . 

130 Used to .hold B7 when a TYPEC REX service request is made. 

131 Contains options from "REX" and PS control cards. 
Options A through Z are reflected by the correspond- 
ing bit through 26 respectively being set. 

132 Used to contain counts for card reader functions during 
execution of REX card service requests. 

133 Lower contains indicator that a REX TAKEOVER was given 
by REXecuted program. 

134 Upper ■ contains indicator to PcEXecutor program is being 
abnormally terminated. Lower contains indicator that 
program is being terminated due to STOPRim or TERMRUN. 

135 Contains todays date by REX conventions. 

I36-I46 Normally ?JE,X service registers error positions may be 
used to call abnormal user fiinctions. 

147 Contains Time of Day REXecuted program was activated. 

1 50-1 57 Reserved for user service calls ^peculiar to instal- 
lation. 



9.6.8-4 



Words 160-237 

Contains segment descriptors of a 3-22 program loaded for PJHecutior 
and are ordered by segment number. Each descriptor is composed of 
two words as "follows: 

' Word 



■ 
1 



V 



LENGTH OF SEGMENT 



LOGICAL INCREMENT OF SEGMENT 



Word - contains length of segment in words determined at load 
time. 2 ^'^^set to (I) implies segment errata is present on . 
mass storage. » 

Word 1 - contains logical increment of segment on random access 
storage relative to file code ZG. 

Each segment descriptor entered in list is in ascending order by 
segment number. Address of called segment is determined by 

L(word 123) + 2 (segment #) 

Once obtained ESZecutor will load Load segment and errata. 



9.6.8-5 



Words 240-267 Table 1 . (MEANS Table) 

Purpose: Used to contain user supplied parameters to effect 

the interpretation of a REX l/O packet at execution 
time. Table 1 is formed from MEANS statements during 
initialization of Phase 1 of ESXecutor and. is contained 
in the execution area of the program. 

Format: Table 1- is of variable length dependent upon the number 
of MEANS statement Each entry within Table 1 is of 
the following format: 



29 : 




OMEGA Pile Code 



Peripheral 
T^e # 



REX' 
ch/unit 



Where -ch/unit number supplied by User via MEANS control card. 
Unit and/or channel value specified on MEANS card must 
match that contained in l/O packet at execution time. 

PerJDheral type number for which the original REX I/O 
packet was coded for. This number is implied by tiB 
mnemonic used on MEANS card. 



1 = FH880 
2-= FAST 
3 = UN2A , 

/ _ TTTVTon 

5 = UN3A 



6 = GRIN 

7 = GROUT 

10 = PRINT 

11 = PTIN 

12 = PTOUT 



13 = Primaiy Input 

14 = Primary Output 

15 = Secondary Output 
16-37 = Unassigned 



A set to (l) implies channel has units; search must be 
made on both channel and unit. The only peripheral types 
recognized requiring unit search are the tapes peripheral 
type 3, 4 and 5. 

B set to (1) indicates unit is mass storage device requir- 
ing use of Table 1A to map drum address to logical in- 
crement and determine file code. 

C set to (1) indicates channel/unit are to be used to 
satisfy an internal facility request, REX packet. Once 
used to satisfy internal reqiest (C) will be cleared and 
entry will function in the normal manner for subsequent 
l/O packets. 



9.6.8-6 



File Code - OMEGA file code to which refonnatted 
l/O request is to be suhndtted. 



Words 270-317 

TABLE 1A (Drum Area Descriptors) 

Purpose: Used to contain User supplied parameters to effect 
the transition of Drum address presented .via REX 
■ calls to logical increment used by OMEGA Table 1A 
-, is formed from MEANS statements during initialization, 
Phase 1 of REXecutor, and is contained in execution 
area of EEXecuted program. ■ ' . 

.Format'; Table 1A is of variable length dependent upon number 
of MEANS statements describing mass storage were 
submitted. Each entry in the table is composed of 
three words in the following format; 



Word 

1 
2 



OMEGA FILE CODE 



PERIPHERAL TYPE 



BEGINNING DRU>I ADDRESS 



ENDING DRUM ADDRESS 



Where- OMEGA File Code is where equivalent mass storage file 
is assigned to task. 

Peripheral Type contains the peripheral type number 
of mass storage for which the' REXecuted program was 
' coded. 2 implies FASTRAND in which after a find is 
made conversion is as follows: 

33^o{^TViQ. Address - Word 1) = Logical Increment 

1 implies FH-880 in which the conversion is as follows: 

(Drum Address - Word 1) = Logical Increment 

Beginning Dram Address is the base address (word 
or sector) which the REXecuted program assumes as 
the base of its mass storage file. 

Ending Drum Address is the number of words or sectors 
contained in the original file plus Beginning Drum 
Address. '^ 



9.6.8-7 



A REXMOD are pseudo REX storage modiiles used to contain 
program registers and status for return of control follow- 
ing the completion of RSX service request.. Each REXMOD is 
of the following format: 

Word 





: 1 

2 
3 
4 
5 
6 
7 
10 



STATUS 


B1 


P 


B2 


■ RETURN POINT 


B3 


•• ■ NORMAL RETURN 


B4 


ERROR RETURN 


B5 


P-TYPE 


B6 




B7 


A 


Q 



Status - is an indicator reflecting current status of request. 

- REXMOD is currently unused 

1,- Request has been queued to Activity 2, CKSTAT has not 
been given. 

2 - Request is complete, or CKSTAT with E.A.S. given. 

3 -Request complete and CKSTAT with E.A.S. given eligible 

for return of control upon execution of TAKEOVER. 

5 - Request queued to Activity 2 or_ CKSTAT and wait given, 

6 - Request complete and CKSTAT and wait given. Eligible 

for return of control. 
77777 - REXMOD has been selected for return of program control 
and has been queued to Activity 2. 



P contains packet or request address relative to RIR of activity. 

Return Point - address relative to RIR to which program control 
is to be returned. 

Normal Return - address relative to RIR, to which program control 
is eligible if request completed without error. 

Error Return - address relative to RIR, to which program control 
is eligible if request completed in error. 1 indicates STOPRUN 
which will cause termination of program. 

B.1-B7, A & Q are register settings used to retiirn control to 
requestor. 
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Sc-Vvt'CC' |?^t^arrri^ 
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CC<:?vf '^:^Citf-^ ^^:fJ^i 




ye.5 



i//<j 



^ ^JCt" t r : Scrco -^ <f "/ y 

d^O'-^ •- : . 






( 

















Vf^ 

















^^ 



M&ts<*<i e si? 1>- i^^ i1 
ov 12_ 







-Vi> 



B 2 -^v i3 - 




D 
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{Pv^'t^^ T&c^Q.^ o^ ^ 







\_ 



Vi.-^J/iOp 



7 



• Stavf p of v<?-^,yeoCr 











A'O 








/t& 






• CL(ra\^ 


^BXMOP 




« 66o*i- 


P fv<5iA^ 


CyOii 


=€? 


Sf^-.O^ 






• 56C: 


5<i«6c/j 


^d 







PKasp 



FC o<^ 



I i 
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.... A 












9.6.8-13 







9.6.8-14. 














Yes 




Stt'*^^ /v^exKoD; 










i 




yes 



>v. 


pv/o :. 





\^e*KOD<i Store,, 
V^i^t^^ G-w;fe €r«-6v^ 





yes 




NiO 






\aA*»c-- 









R« ! 







o4- RexKoO 



9.6.8-15 





I i 



'Pa^^ -"i 0% ^ 



:0 



'pro- C^ia^} 



//o 






' Ac£»\»:6r^ 




^3»?e;^ 



/ 




^— ^ -ji RBkmod stupa5> 






I . • i- i 



1 ! 



9.6.8->l6: 



D. List of MACROS simulating 4-94. instructions on the 4-90. 



These are the 77 XX instructions on the 494- and are illegal instructions 
•on the 4-90. All macros are constructed so that coding will be identical 
to that on the 4-94.^ ^»S-} ^ conditional jump instruction preceding a 
macro will jump around the macro, if the skip condition is satisfied 
without any special coding requirements for the programmer. 



77 21 
77 23 



77 24 



77 25 



DPENT 



DPCME 



DPGP^ 



DPSTR 



Double precision enter. (Y)-^A, (I+1)-^ Q. 

Compare I and Y-M to A and Q respectively. 
Skip next instruction if equality found. 

Double precision complement. (A) — ^ A 
(Q)'-^Q 

Double precision store. (A)-->Y, (Q)'-S>Y+1 



77 4x 



EBJPySx The P value is entered in Bx and jiimp 
performed to Y . 



77 32 



TSET 



Tests bit 14 of Y; if not set it is set 

and bits 13-00 are cleared. If set jump 

to' TSETENTRY subroutine. Packet is saved 
within the macro. 



77 54 



EXRN 



The macro sets up a return jump to 
TEXECENTRY location is simulated OMEGA. 
-The lower half of the EXEC return instruction 
must be provided as a parameter, e.g. for 
77540 00002 the 00002 must be supplied 
as the parameter in the coding. 



A-4 



xiiQ lOxxOving ins orucbions can CTi^y uS used by "tlie sxecu'ti'v'S so a "bsst- 
is performed on L(GARDMODIND) to determine if in executive mode (if=$^, 
-it is in exec mode). If it is in exec mode the instruction is legal 
and ^ can be executed; if not, the macro contains a return jump to error 
location. All instructions above 77 60 are exec only instructions. 

7"^ 61 EIFR Test new IFR to see if it indicates 
' ":-: exec or worker B-registers are to 

be used. Test' old IFR to see which 
set is active . If wrong set is active 
:.-.,. ..., store that set and enter the other set. 
:' " Then IFR is entered with Y value and 
RIR is entered with (Y+1) , 

77 62 ' EPLR Enter Program Lock registerwith value 

in Y. 

77 6$, SIFR Store value in Internal Function Register 

in address specified by Y , 

77 66 ERIR Enter Relative Index Register with value 

inY. 

77 7f EWB Enter worker B registers; (Y)-^B1, 

(Y+1)-^B2, ^+2)^33, etc. 

.77 72 STRC Store Channel number. Test where channel 

number is and store it in Y address. The 
channel number could be in CSR or lASREG. 

77 73 ECSR Store lower five bits of Y address in 

lower of Channel Select Register. 

77 75 SWB Store worker B registers (B1)-^Y, 

(B2)-^ Y+1, etc. 

All assemblies for Omega on 490 simulation should include these macros 
in the card deck to facilitate familiarity with the 4-94- coding repetoire. 
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